You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
description: This article describes how the SQL Server IaaS Agent extension helps automate management specific administration tasks of SQL Server on Linux Azure VMs.
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)
22
22
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.
24
24
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).
25
26
26
27
## Overview
27
28
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.
29
30
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
31
32
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.
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.
39
38
40
-
# [Azure CLI](#tab/azure-cli)
39
+
### [PowerShell](#tab/azure-powershell)
41
40
42
-
```azurecli-interactive
43
-
$ az sql vm list --query "[?sqlServerLicenseType=='AHUB']"
-**Free**: There is no additional cost associated with the extension.
45
+
### [Azure CLI](#tab/azure-cli)
48
46
47
+
```azurecli-interactive
48
+
az sql vm list --query "[?sqlServerLicenseType=='AHUB']"
49
+
```
49
50
51
+
---
50
52
51
-
##Installation
53
+
### Free
52
54
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.
54
56
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.
56
60
61
+
The SQL Server IaaS Agent extension for Linux is currently available with limited functionality.
57
62
58
63
## Verify extension status
59
64
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.
61
66
62
67
### Azure portal
63
68
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.
67
70
68
-

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:
69
72
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":::
70
74
71
75
### Azure PowerShell
72
76
@@ -79,32 +83,36 @@ You can also use the **Get-AzVMSqlServerExtension** Azure PowerShell cmdlet:
79
83
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:
- SQL Server with only a single instance. Multiple instances aren't supported.
98
104
99
-
When using SQL Server on Azure VMs and the SQL IaaS Agent extension, consider the following privacy statements:
105
+
<aid="in-region-data-residency"></a>
100
106
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
102
108
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:
104
110
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).
105
112
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.
107
114
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
109
116
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