Skip to content

Commit ea65497

Browse files
authored
Merge pull request #36494 from rwestMSFT/rw-0127-freshness
Freshness and minor ADS reference tweaks
2 parents 5de013f + d4e592a commit ea65497

6 files changed

Lines changed: 1205 additions & 1145 deletions

File tree

Lines changed: 55 additions & 47 deletions
Original file line numberDiff line numberDiff line change
@@ -1,72 +1,76 @@
11
---
2-
title: SQL Server IaaS Agent extension for Linux
2+
title: SQL Server IaaS Agent Extension for Linux
33
description: This article describes how the SQL Server IaaS Agent extension helps automate management specific administration tasks of SQL Server on Linux Azure VMs.
44
author: bluefooted
55
ms.author: pamela
6-
ms.reviewer: mathoma
7-
ms.date: 05/22/2023
6+
ms.reviewer: mathoma, randolphwest
7+
ms.date: 01/27/2026
88
ms.service: azure-vm-sql-server
99
ms.subservice: management
1010
ms.topic: concept-article
11+
ms.custom:
12+
- linux-related-content
1113
tags: azure-resource-manager
12-
ms.custom: linux-related-content
1314
---
1415
# SQL Server IaaS Agent extension for Linux
15-
[!INCLUDE[appliesto-sqlvm](../../includes/appliesto-sqlvm.md)]
1616

17-
> [!div class="op_single_selector"]
18-
> * [Windows](../windows/sql-server-iaas-agent-extension-automate-management.md)
19-
> * [Linux](sql-server-iaas-agent-extension-linux.md)
17+
[!INCLUDE [appliesto-sqlvm](../../includes/appliesto-sqlvm.md)]
2018

21-
The SQL Server IaaS Agent extension (SqlIaasExtension) runs on SQL Server on Linux Azure Virtual Machines (VMs) to automate management and administration tasks.
19+
> [!div class="op_single_selector"]
20+
> - [Automate management with the Windows SQL Server IaaS Agent extension](../windows/sql-server-iaas-agent-extension-automate-management.md)
21+
> - [SQL Server IaaS Agent extension for Linux](sql-server-iaas-agent-extension-linux.md)
2222
23-
This article provides an overview of the extension. See [Register with the extension](sql-iaas-agent-extension-register-vm-linux.md) to learn more.
23+
Run the SQL Server IaaS Agent extension (SqlIaasExtension) on SQL Server on Linux Azure Virtual Machines (VMs) to automate management and administration tasks.
2424

25+
This article provides an overview of the extension. For more information, see [Register Linux SQL Server VM with SQL IaaS Agent extension](sql-iaas-agent-extension-register-vm-linux.md).
2526

2627
## Overview
2728

28-
The SQL Server IaaS Agent extension enables integration with the Azure portal and unlocks the following benefits for SQL Server on Linux Azure VMs:
29+
The SQL Server IaaS Agent extension enables integration with the Azure portal and unlocks several benefits for SQL Server on Linux Azure VMs.
2930

30-
- **Compliance**: The extension offers a simplified method to fulfill the requirement of notifying Microsoft that the Azure Hybrid Benefit has been enabled as is specified in the product terms. This process negates needing to manage licensing registration forms for each resource.
31+
### Compliance
3132

32-
- **Simplified license management**: The extension simplifies SQL Server license management, and allows you to quickly identify SQL Server VMs with the Azure Hybrid Benefit enabled using the Azure portal, Azure PowerShell or the Azure CLI:
33+
The extension offers a simplified method to fulfill the requirement of notifying Microsoft that the Azure Hybrid Benefit is enabled as specified in the product terms. This process negates the need to manage licensing registration forms for each resource.
3334

34-
# [PowerShell](#tab/azure-powershell)
35+
### Simplified license management
3536

36-
```powershell-interactive
37-
Get-AzSqlVM | Where-Object {$_.LicenseType -eq 'AHUB'}
38-
```
37+
The extension simplifies SQL Server license management, and allows you to quickly identify SQL Server VMs with the Azure Hybrid Benefit enabled by using the Azure portal, Azure PowerShell, or the Azure CLI.
3938

40-
# [Azure CLI](#tab/azure-cli)
39+
### [PowerShell](#tab/azure-powershell)
4140

42-
```azurecli-interactive
43-
$ az sql vm list --query "[?sqlServerLicenseType=='AHUB']"
44-
```
45-
---
41+
```powershell-interactive
42+
Get-AzSqlVM | Where-Object {$_.LicenseType -eq 'AHUB'}
43+
```
4644

47-
- **Free**: There is no additional cost associated with the extension.
45+
### [Azure CLI](#tab/azure-cli)
4846

47+
```azurecli-interactive
48+
az sql vm list --query "[?sqlServerLicenseType=='AHUB']"
49+
```
4950

51+
---
5052

51-
## Installation
53+
### Free
5254

53-
[Register](sql-iaas-agent-extension-register-vm-linux.md) your SQL Server VM with the SQL Server IaaS Agent extension to create the **SQL virtual machine** _resource_ within your subscription, which is a _separate_ resource from the virtual machine resource. Unregistering your SQL Server VM from the extension will remove the **SQL virtual machine** _resource_ from your subscription but will not drop the actual virtual machine.
55+
There's no extra cost for using the extension.
5456

55-
The SQL Server IaaS Agent extension for Linux is currently only available with limited functionality.
57+
## Installation
58+
59+
[Register](sql-iaas-agent-extension-register-vm-linux.md) your SQL Server VM with the SQL Server IaaS Agent extension to create the **SQL virtual machine** *resource* within your subscription. This resource is *separate* from the virtual machine resource. When you unregister your SQL Server VM from the extension, you remove the **SQL virtual machine** *resource* from your subscription but don't delete the actual virtual machine.
5660

61+
The SQL Server IaaS Agent extension for Linux is currently available with limited functionality.
5762

5863
## Verify extension status
5964

60-
Use the Azure portal or Azure PowerShell to check the status of the extension.
65+
Use the Azure portal or Azure PowerShell to check the status of the extension.
6166

6267
### Azure portal
6368

64-
Verify the extension is installed by using the Azure portal.
65-
66-
Go to your **Virtual machine** resource in the Azure portal (not the *SQL virtual machines* resource, but the resource for your VM). Select **Extensions** under **Settings**. You should see the **SqlIaasExtension** extension listed, as in the following example:
69+
Verify the extension is installed by using the Azure portal.
6770

68-
![Check the Status of the SQL Server IaaS Agent extension SqlIaaSExtension in the Azure portal](../windows/media/sql-server-iaas-agent-extension-automate-management/azure-rm-sql-server-iaas-agent-portal.png)
71+
Go to your **Virtual machine** resource in the Azure portal (not the *SQL virtual machines* resource, but the resource for your VM). Select **Extensions** under **Settings**. You should see the **SqlIaasExtension** extension listed, as in the following example:
6972

73+
:::image type="content" source="../windows/media/sql-server-iaas-agent-extension-automate-management/azure-rm-sql-server-iaas-agent-portal.png" alt-text="Screenshot of Check the Status of the SQL Server IaaS Agent extension SqlIaaSExtension in the Azure portal." lightbox="../windows/media/sql-server-iaas-agent-extension-automate-management/azure-rm-sql-server-iaas-agent-portal.png":::
7074

7175
### Azure PowerShell
7276

@@ -79,32 +83,36 @@ You can also use the **Get-AzVMSqlServerExtension** Azure PowerShell cmdlet:
7983
The previous command confirms that the agent is installed and provides general status information. You can get specific status information about automated backup and patching by using the following commands:
8084

8185
```powershell-interactive
82-
$sqlext = Get-AzVMSqlServerExtension -VMName "vmname" -ResourceGroupName "resourcegroupname"
83-
$sqlext.AutoPatchingSettings
84-
$sqlext.AutoBackupSettings
86+
$sqlext = Get-AzVMSqlServerExtension -VMName "vmname" -ResourceGroupName "resourcegroupname"
87+
$sqlext.AutoPatchingSettings
88+
$sqlext.AutoBackupSettings
8589
```
8690

8791
## Limitations
8892

89-
The Linux SQL IaaS Agent extension has the following limitations:
93+
The Linux SQL IaaS Agent extension has the following limitations:
94+
95+
- Only SQL Server VMs running on the Ubuntu Linux operating system are supported. Other Linux distributions aren't currently supported.
96+
97+
- SQL Server VMs running Ubuntu Pro aren't supported.
98+
99+
- SQL Server VMs running on generalized images aren't supported.
90100

91-
- Only SQL Server VMs running on the Ubuntu Linux operating system are supported. Other Linux distributions are not currently supported.
92-
- SQL Server VMs running Ubuntu Linux Pro are not supported.
93-
- SQL Server VMs running on generalized images are not supported.
94-
- Only SQL Server VMs deployed through the Azure Resource Manager are supported. SQL Server VMs deployed through the classic model are not supported.
95-
- SQL Server with only a single instance. Multiple instances are not supported.
101+
- Only SQL Server VMs deployed through the Azure Resource Manager are supported. SQL Server VMs deployed through the classic model aren't supported.
96102

97-
## <a id="in-region-data-residency"></a> Privacy statement
103+
- SQL Server with only a single instance. Multiple instances aren't supported.
98104

99-
When using SQL Server on Azure VMs and the SQL IaaS Agent extension, consider the following privacy statements:
105+
<a id="in-region-data-residency"></a>
100106

101-
- **Data collection**: The SQL IaaS Agent extension collects data for the express purpose of giving customers optional benefits when using SQL Server on Azure Virtual Machines. Microsoft **will not use this data for licensing audits** without the customer's advance consent. See the [SQL Server privacy supplement](/sql/sql-server/sql-server-privacy#non-personal-data) for more information.
107+
## Privacy statement
102108

103-
- **In-region data residency**: SQL Server on Azure VMs and SQL IaaS Agent Extension do not move or store customer data out of the region in which the VMs are deployed.
109+
When using SQL Server on Azure VMs and the SQL IaaS Agent extension, consider the following privacy statements:
104110

111+
- **Data collection**: The SQL IaaS Agent extension collects data to provide optional benefits when using SQL Server on Azure Virtual Machines. Microsoft **does not use this data for licensing audits** without the customer's advance consent. For more information, see the [SQL Server privacy supplement](/sql/sql-server/sql-server-privacy#non-personal-data).
105112

106-
## Next steps
113+
- **In-region data residency**: SQL Server on Azure VMs and SQL IaaS Agent Extension don't move or store customer data outside the region where you deploy the VMs.
107114

108-
For more information about running SQL Server on Azure Virtual Machines, see the [What is SQL Server on Azure Linux Virtual Machines?](sql-server-on-linux-vm-what-is-iaas-overview.md).
115+
## Related content
109116

110-
To learn more, see [frequently asked questions](frequently-asked-questions-faq.yml).
117+
- [Overview of SQL Server on Linux Azure Virtual Machines](sql-server-on-linux-vm-what-is-iaas-overview.md)
118+
- [Frequently asked questions for SQL Server on Linux virtual machines](frequently-asked-questions-faq.yml)

0 commit comments

Comments
 (0)