Skip to content

Commit 27be7b1

Browse files
Fix UUF documentation issues: links, permissions, code, portal UI, setup wizard (#36666)
* Fix UUF content issues: broken link, priority clarification, DNS suffix guidance * Apply suggestions from PR review --------- Co-authored-by: Stacy Chambers <102548089+Stacyrch140@users.noreply.github.com>
1 parent 033a00e commit 27be7b1

15 files changed

Lines changed: 84 additions & 42 deletions

File tree

azure-sql/database/reservations-discount-overview.md

Lines changed: 6 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -2,10 +2,10 @@
22
title: Save on compute costs with Azure Reservations
33
titleSuffix: Azure SQL Database & SQL Managed Instance
44
description: Learn how to buy Azure SQL Database and SQL Managed Instance reservations to save on your compute costs.
5-
author: rajeshsetlem
6-
ms.author: rsetlem
5+
author: WilliamDAssafMSFT
6+
ms.author: wiassaf
77
ms.reviewer: wiassaf, mathoma
8-
ms.date: 12/01/2025
8+
ms.date: 02/23/2026
99
ms.service: azure-sql
1010
ms.subservice: service-overview
1111
ms.topic: how-to
@@ -93,6 +93,9 @@ Carefully evaluate your compute needs and reservation strategy to optimize costs
9393

9494
:::image type="content" source="./media/reserved-capacity-overview/sql-reserved-vcores-purchase.png" alt-text="Screenshot before submitting the reservation purchase.":::
9595

96+
> [!NOTE]
97+
> The **Elastic pool** in the SQL Database name is the name of the Azure SQL resource, and does not imply that reservations are available for elastic pools.
98+
9699
The following table describes the required fields.
97100

98101
| Field | Description|

azure-sql/managed-instance/automated-backups-change-settings.md

Lines changed: 15 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ description: Change point-in-time restore and backup redundancy options for auto
55
author: dinethi
66
ms.author: dinethi
77
ms.reviewer: wiassaf, mathoma, strrodic, mlandzic
8-
ms.date: 07/08/2025
8+
ms.date: 02/23/2026
99
ms.service: azure-sql-managed-instance
1010
ms.subservice: backup-restore
1111
ms.topic: how-to
@@ -127,15 +127,16 @@ For more information, see the [Backup retention PowerShell command](/powershell/
127127
#### Sample request
128128

129129
```http
130-
PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/resourceGroup/providers/Microsoft.Sql/managedInstances/testManagedInstance/databases/testDatabase/backupShortTermRetentionPolicies/default?api-version=2017-10-01-preview
130+
PATCH https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/resourceGroup/providers/Microsoft.Sql/managedInstances/testSQLMI/databases/testdb/backupShortTermRetentionPolicies/default?api-version=2023-08-01
131+
131132
```
132133

133134
#### Request body
134135

135136
```json
136137
{
137-
"properties":{
138-
"retentionDays":28
138+
"properties": {
139+
"retentionDays": 14
139140
}
140141
}
141142
```
@@ -146,15 +147,22 @@ Status code: 200
146147

147148
```json
148149
{
149-
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/resourceGroups/resourceGroup/managedInstances/testserver/databases/testDatabase/backupShortTermRetentionPolicies/default",
150+
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/resourceGroup/providers/Microsoft.Sql/managedInstances/testSQLMI/databases/testdb/backupShortTermRetentionPolicies/default",
150151
"name": "default",
151-
"type": "Microsoft.Sql/resourceGroups/managedInstances/databases/backupShortTermRetentionPolicies",
152+
"type": "Microsoft.Sql/managedInstances/databases/backupShortTermRetentionPolicies",
152153
"properties": {
153-
"retentionDays": 28
154+
"retentionDays": 14
154155
}
155156
}
156157
```
157158

159+
Status code: 202
160+
161+
```http
162+
Location: https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/locations/westus/managedShortTermRetentionPolicyOperationResults/00000000-1111-2222-3333-444444444444?api-version=2017-03-01-preview
163+
```
164+
165+
158166
For more information, see the [Backup retention REST API](/rest/api/sql/managed-backup-short-term-retention-policies).
159167

160168
---

azure-sql/managed-instance/public-endpoint-configure.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -169,7 +169,7 @@ Use the Azure portal to allow public traffic within the network security group.
169169
|**Destination port ranges** |3342 |Scope destination port to 3342, which is the SQL managed instance public TDS endpoint |
170170
|**Protocol** |TCP |SQL Managed Instance uses TCP protocol for TDS |
171171
|**Action** |Allow |Allow inbound traffic to SQL managed instance through the public endpoint |
172-
|**Priority** |1300 |Make sure this rule is higher priority than the **deny_all_inbound** rule |
172+
|**Priority** |1300 |Make sure this rule has a lower priority number than the **deny_all_inbound** rule (lower numbers = higher priority, for example, 1300 is higher priority than 2000) |
173173

174174
:::image type="content" source="./media/public-endpoint-configure/mi-nsg-rules.png" alt-text="Screenshot shows the Inbound security rules with your new public_endpoint_inbound rule above the deny_all_inbound rule.":::
175175

azure-sql/managed-instance/sql-managed-instance-paas-overview.md

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -58,8 +58,7 @@ The following table provides key capabilities of Azure SQL Managed Instance:
5858
| Isolated environment ([Connectivity architecture for Azure SQL Managed Instance](connectivity-architecture-overview.md), single tenant service, dedicated compute and storage)<br />Adheres to the same compliance standards as Azure SQL Database<br />[Transparent data encryption (TDE)](/sql/relational-databases/security/encryption/transparent-data-encryption-azure-sql)<br />[Use Microsoft Entra authentication](../database/authentication-aad-overview.md), single sign-on support<br />[Microsoft Entra server principals (logins)](/sql/t-sql/statements/create-login-transact-sql?view=azuresqldb-mi-current&preserve-view=true)<br />[What is Windows Authentication for Microsoft Entra principals on Azure SQL Managed Instance?](winauth-azuread-overview.md)<br />[Get started with Azure SQL Managed Instance auditing](auditing-configure.md)<br />[Configure Advanced Threat Protection in Azure SQL Managed Instance](threat-detection-configure.md) | Azure Resource Manager API for automating service provisioning and scaling<br />Azure portal functionality for manual service provisioning and scaling<br />Data Migration Service |
5959

6060
> [!IMPORTANT]
61-
> Azure SQL Managed Instance is certified against a number of compliance standards. For more information, see the [Azure Compliance Offerings](https://servicetrust.microsoft.com/ViewPage/MSComplianceGuideV3?command=Download&downloadType=Document&downloadId=44bbae63-bf4d-4e3b-9d3d-c96fb25ec363&tab=7027ead0-3d6b-11e9-b9e1-290b1eb4cdeb&docTab=7027ead0-3d6b-11e9-b9e1-290b1eb4cdeb_FAQ_and_White_Papers), where you can find the most current list of Azure SQL Managed Instance compliance certifications, listed under **Azure SQL Database**.
62-
61+
> Azure SQL Managed Instance is certified against a number of compliance standards. For more information, see the [Microsoft Trust Center](https://www.microsoft.com/trust-center/compliance/compliance-overview), where you can find the most current list of Azure SQL Managed Instance compliance certifications.
6362
The following table shows characteristics of SQL Managed Instance:
6463

6564
| Feature | Description |

azure-sql/virtual-machines/windows/automated-backup.md

Lines changed: 11 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: This article explains the Automated Backup feature for SQL Server 2
44
author: AbdullahMSFT
55
ms.author: amamun
66
ms.reviewer: mathoma
7-
ms.date: 09/22/2025
7+
ms.date: 02/23/2026
88
ms.service: azure-vm-sql-server
99
ms.subservice: backup
1010
ms.topic: how-to
@@ -134,9 +134,11 @@ The following Azure portal screenshot shows the **Automated Backup** settings wh
134134

135135
For existing SQL Server virtual machines, go to the [SQL virtual machines resource](manage-sql-vm-portal.md#access-the-resource) and then select **Backups** to configure your Automated Backups.
136136

137-
Select **Enable** to configure your Automated Backup settings.
137+
Select **Enable** on the **Automated Backup** tile to configure your Automated Backup settings:
138138

139-
You can configure the retention period (up to 90 days), the container for the storage account where you want to store your backups, the encryption, and the backup schedule. By default, the schedule is automated.
139+
:::image type="content" source="media/automated-backup/select-automated-backup.png" alt-text="Screenshot of how to select automated backup on the backup blade for your SQL VM in the Azure portal." lightbox="media/automated-backup/select-automated-backup.png":::
140+
141+
On the **Backups** page, select **Enable** to turn on Automated Backup. You can configure the retention period (up to 90 days), the container for the storage account where you want to store your backups, the encryption, and the backup schedule. By default, the schedule is automated. Configure the settings as needed:
140142

141143
:::image type="content" source="./media/automated-backup/sql-server-configuration.png" alt-text="Screenshot of Automated Backup for existing VMs in the portal.":::
142144

@@ -148,18 +150,18 @@ When finished, select the **Apply** button on the bottom of the **Backups** sett
148150

149151
If you're enabling Automated Backup for the first time, Azure configures the SQL Server IaaS Agent in the background. During this time, the Azure portal might not show that Automated Backup is configured. Wait several minutes for the agent to be installed, configured. After that, the Azure portal will reflect the new settings.
150152

153+
If you only see [Azure Backup](backup-restore.md#azbackup) as the backup type, then [Disable Azure Backup by deleting the associated Azure Vault](backup-restore.md#disable-azure-backup), and then choose **Automated Backup** to use Automated Backup instead.
154+
151155
## Configure with PowerShell
152156

153157
You can use PowerShell to configure Automated Backup. Before you begin, you must:
154158

155-
- [Download and install the latest Azure PowerShell](https://aka.ms/webpi-azps).
159+
- [Download and install the latest Azure PowerShell](/powershell/azure/install-azure-powershell).
156160
- Open Windows PowerShell and associate it with your account with the **Connect-AzAccount** command.
157161

158-
[!INCLUDE [updated-for-az.md](../../includes/updated-for-az.md)]
159-
160162
### Install the SQL Server IaaS Extension
161163

162-
If you provisioned a SQL Server virtual machine from the Azure portal, the SQL Server IaaS Extension should already be installed. You can determine whether it's installed for your VM by calling **Get-AzVM** command and examining the **Extensions** property.
164+
If you provisioned a SQL Server virtual machine from the Azure portal, the SQL Server IaaS Agent extension should already be installed. You can determine whether it's installed for your VM by calling **Get-AzVM** command and examining the **Extensions** property.
163165

164166
```powershell
165167
$vmname = "yourvmname"
@@ -170,7 +172,7 @@ $resourcegroupname = "yourresourcegroupname"
170172

171173
If the SQL Server IaaS Agent extension is installed, you should see it listed as `SqlIaaSAgent` or `SQLIaaSExtension.` **ProvisioningState** for the extension should also show "Succeeded."
172174

173-
If it isn't installed or it has failed to be provisioned, you can install it with the following command. In addition to the VM name and resource group, you must also specify the region (**$region**) that your VM is located in.
175+
If it isn't installed or provisioning failed, you can install it with the [Set-AzVMSqlServerExtension](/powershell/module/az.compute/set-azvmsqlserverextension) command. In addition to the VM name and resource group, you must also specify the region (**$region**) that your VM is located in.
174176

175177
```powershell
176178
$region = "EASTUS2"
@@ -425,6 +427,7 @@ The following table lists the possible solutions if you're having issues enablin
425427
| **Backup Multiple SQL instances using Automated Backup** | Automated Backup currently only supports one SQL Server instance. If you have multiple named instances, and the default instance, Automated Backup works with the default instance. If you have multiple named instances and no default instance, turning on Automated Backup will fail. |
426428
| **Automated Backup can't be enabled due to account and permissions** | Check the following: <br /> - The SQL Server Agent is running. <br /> - The **NT Service\SqlIaaSExtensionQuery** account has proper [permissions](sql-server-iaas-agent-extension-automate-management.md#permissions-models) for the Automated Backup feature both within SQL Server, and also for the [SQL virtual machines](manage-sql-vm-portal.md) resource in the Azure portal. <br /> - The **SA** account hasn't been renamed, though disabling the account is acceptable. |
427429
| **Automated Backup fails for SQL 2016 +**| **Allow Blob Public Access** is enabled on the storage Account. This solution provides a temporary workaround to a known issue. |
430+
|**The account being accessed does not have sufficient permissions to execute this operation** | This error occurs when the user lacks sufficient permissions to the storage account or container, or you select the default `$logs` container for backup storage. To resolve this issue, create a new container in your storage account and use that container for your backups instead of the default `$logs` container. |
428431

429432
### Common issues with Automated or Managed Backups
430433

azure-sql/virtual-machines/windows/backup-restore.md

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -70,6 +70,24 @@ For more information on how to configure Automated Backup for SQL VMs, see one o
7070

7171
This Azure Backup solution for SQL VMs is generally available. For more information, see [Back up SQL Server database to Azure](/azure/backup/backup-azure-sql-database).
7272

73+
To use Azure backup, you must first make sure Automated backup is disabled.
74+
75+
### Disable Azure Backup
76+
77+
To disable Azure Backups, you have to delete the associated vault. To delete the vault, follow these steps:
78+
79+
1. Go to [Recovery Services vaults in the Azure portal](https://portal.azure.com/#browse/Microsoft.RecoveryServices%2Fvaults) and select the vault that contains your SQL Server Azure Backups.
80+
1. Under **Protected items** select **Backup items**.
81+
1. On the **Backup items** page, select the **SQL Database in Azure VM** backup management type.
82+
1. Select the ellipses (...) next to each database, and then select **Stop backup** to go to the **Stop backup** page.
83+
1. On the **Stop backup** page, select **Delete backup data** and then select **OK** to disable Azure Backup and delete the backup data for that database.
84+
1. Go back to the vault, and under **Manage**, select **Backup Infrastructure**.
85+
1. On the **Overview** blade of the **Backup Infrastructure** page, select **Workload in Azure VM**.
86+
1. On the **Protected Servers (Workload in Azure VM)** page, select the ellipses (...) next to the SQL Server VM, and then select **Unregister** to remove the SQL Server VM from Azure Backup protection.
87+
1. Go back to the vault, and then use **Delete** to delete the vault.
88+
1. After the vault is deleted, Azure Backup is disabled for your [SQL virtual machine resource](manage-sql-vm-portal.md#backups)
89+
90+
7391
<a id="manual"></a>
7492

7593
## Manual backup

azure-sql/virtual-machines/windows/manage-sql-vm-portal.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -106,6 +106,8 @@ Use the **Backups** page of the SQL virtual machines resource to choose between
106106

107107
Regardless of which backup solution you choose, you can use the **Backups** page to configure your backup settings, such as the retention period, backup storage location, encryption, whether or not to back up system databases, and a backup schedule.
108108

109+
To use Azure backup, you must first make sure Automated backup is disabled.
110+
109111
## Modernization Advisor (preview)
110112

111113
The [Modernization Advisor (Preview)](../modernization-advisor.md) assesses your SQL Server workload to identify cost-saving or performance optimizations you might gain by migrating to Azure SQL Managed Instance. This feature is currently in preview.
61.6 KB
Loading
23.2 KB
Loading

docs/database-engine/availability-groups/windows/domain-independent-availability-groups.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -60,6 +60,10 @@ A common DNS suffix is necessary for a domain independent availability group's w
6060
1. On the System Properties dialog, select **Change** on the Computer Name tab.
6161
1. On the Computer Name/Domain Changes dialog, select **More**.
6262
1. On the DNS Suffix and NetBIOS Computer Name dialog, enter the common DNS suffix as the **Primary DNS** suffix.
63+
64+
> [!NOTE]
65+
> Specify only the DNS suffix (for example, `CONTOSO.LAB`), not the full computer name. Do not include the hostname in the DNS suffix field.
66+
6367
1. Select **OK** to close the DNS Suffix and NetBIOS Computer Name dialog.
6468
1. Select **OK** to close the Computer Name/Domain Changes dialog.
6569
1. You're prompted to restart the server for the changes to take effect. Select **OK** to close the Computer Name/Domain Changes dialog.

0 commit comments

Comments
 (0)