你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

az sql vm

管理 SQL 虚拟机。

命令

名称 说明 类型 Status
az sql vm add-to-group

将 SQL 虚拟机添加到 SQL 虚拟机组。

Core GA
az sql vm create

创建 SQL 虚拟机。

Core GA
az sql vm delete

删除 SQL 虚拟机。

Core GA
az sql vm enable-azure-ad-auth

启用 SQL 虚拟机的 Azure AD 身份验证。

Core GA
az sql vm group

管理 SQL 虚拟机组。

Core GA
az sql vm group ag-listener

管理 SQL 可用性组侦听器。

Core GA
az sql vm group ag-listener create

创建可用性组侦听器。

Core GA
az sql vm group ag-listener delete

删除可用性组侦听器。

Core GA
az sql vm group ag-listener list

列出 SQL 虚拟机组中的所有可用性组侦听器。

Core GA
az sql vm group ag-listener show

获取可用性组侦听器。

Core GA
az sql vm group ag-listener update

更新可用性组侦听器。

Core GA
az sql vm group create

创建 SQL 虚拟机组。

Core GA
az sql vm group delete

删除 SQL 虚拟机组。

Core GA
az sql vm group list

列出资源组或订阅中的所有 SQL 虚拟机组。

Core GA
az sql vm group show

获取 SQL 虚拟机组。

Core GA
az sql vm group update

如果没有附加到该组的 SQL 虚拟机,请更新 SQL 虚拟机组。

Core GA
az sql vm list

列出资源组或订阅中的所有 SQL 虚拟机。

Core GA
az sql vm remove-from-group

从其当前 SQL 虚拟机组中删除 SQL 虚拟机。

Core GA
az sql vm show

获取 SQL 虚拟机。

Core GA
az sql vm start-assessment

在 SQL 虚拟机上启动 SQL 最佳做法评估。

Core GA
az sql vm update

更新 SQL 虚拟机的属性。

Core GA
az sql vm validate-azure-ad-auth

在客户端验证 SQL 虚拟机的 Azure AD 身份验证,而无需启用它。

Core GA

az sql vm add-to-group

将 SQL 虚拟机添加到 SQL 虚拟机组。

az sql vm add-to-group --sqlvm-group
                       [--bootstrap-acc-pwd]
                       [--ids]
                       [--name]
                       [--operator-acc-pwd]
                       [--resource-group]
                       [--service-acc-pwd]
                       [--subscription]

示例

将 SQL 虚拟机添加到组。

az sql vm add-to-group -n sqlvm -g myresourcegroup --sqlvm-group sqlvmgroup --bootstrap-acc-pwd {bootstrappassword} --operator-acc-pwd {operatorpassword} --service-acc-pwd {servicepassword}

必需参数

--sqlvm-group -r

SQL 虚拟机组的名称或资源 ID。 如果仅提供名称,SQL 虚拟机组应位于 SQL 虚拟机的同一资源组中。

可选参数

以下参数是可选的,但根据上下文,命令可能需要一个或多个参数才能成功执行。

--bootstrap-acc-pwd -b

如果在 SQL 虚拟机组中提供群集启动帐户的密码。

属性
参数组: WSFC Domain Credentials Arguments
--ids

一个或多个资源 ID(以空格分隔)。 它应该是包含“Resource Id”参数的所有信息的完整资源 ID。 应提供 --ids 或其他“Resource Id”参数。

属性
参数组: Resource Id Arguments
--name -n

SQL 虚拟机的名称。

属性
参数组: Resource Id Arguments
--operator-acc-pwd -p

SQL 虚拟机组中提供的群集作员帐户的密码。

属性
参数组: WSFC Domain Credentials Arguments
--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name>配置默认组。

属性
参数组: Resource Id Arguments
--service-acc-pwd -s

SQL 虚拟机组中提供的 SQL 服务帐户的密码。

属性
参数组: WSFC Domain Credentials Arguments
--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

属性
参数组: Resource Id Arguments
全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

属性
默认值: False
--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误,禁止显示警告。

属性
默认值: False
--output -o

输出格式。

属性
默认值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/

--verbose

增加日志记录详细程度。 使用 --debug 获取完整的调试日志。

属性
默认值: False

az sql vm create

创建 SQL 虚拟机。

az sql vm create --name
                 --resource-group
                 [--backup-pwd]
                 [--backup-schedule-type {Automated, Manual}]
                 [--backup-system-dbs {false, true}]
                 [--connectivity-type {LOCAL, PRIVATE, PUBLIC}]
                 [--credential-name]
                 [--day-of-week {Everyday, Friday, Monday, Saturday, Sunday, Thursday, Tuesday, Wednesday}]
                 [--enable-auto-backup {false, true}]
                 [--enable-auto-patching {false, true}]
                 [--enable-encryption {false, true}]
                 [--enable-key-vault-credential {false, true}]
                 [--enable-r-services {false, true}]
                 [--full-backup-duration]
                 [--full-backup-frequency {Daily, Weekly}]
                 [--full-backup-start-hour]
                 [--image-offer]
                 [--image-sku {Developer, Enterprise, Express, Standard, Web}]
                 [--key-vault]
                 [--least-privilege-mode {Enabled, NotSet}]
                 [--license-type {AHUB, DR, PAYG}]
                 [--location]
                 [--log-backup-frequency]
                 [--maintenance-window-duration]
                 [--maintenance-window-start-hour]
                 [--port]
                 [--retention-period]
                 [--sa-key]
                 [--sp-name]
                 [--sp-secret]
                 [--sql-auth-update-pwd]
                 [--sql-auth-update-username]
                 [--sql-mgmt-type {Full, LightWeight, NoAgent}]
                 [--sql-workload-type {DW, GENERAL, OLTP}]
                 [--storage-account]
                 [--tags]

示例

使用 AHUB 计费标记创建 SQL 虚拟机。

az sql vm create -n sqlvm -g myresourcegroup -l eastus --license-type AHUB

创建具有 DR 计费标记的 SQL 虚拟机。

az sql vm create -n sqlvm -g myresourcegroup -l eastus --license-type DR

创建具有特定 SKU 类型和许可证类型的 SQL 虚拟机。

az sql vm create -n sqlvm -g myresourcegroup -l eastus --image-sku Enterprise --license-type AHUB

创建启用了最低特权模式的 SQL 虚拟机。

az sql vm create -n sqlvm -g myresourcegroup -l eastus --least-privilege-mode Enabled --sql-mgmt-type Full

创建具有 NoAgent 类型的 SQL 虚拟机,仅适用于 EOS SQL 2008 和 SQL 2008 R2。

az sql vm create -n sqlvm -g myresourcegroup -l eastus --license-type AHUB --sql-mgmt-type NoAgent --image-sku Enterprise --image-offer SQL2008-WS2008R2

在SQL2016以后启用 R 服务。

az sql vm create -n sqlvm -g myresourcegroup -l eastus --license-type PAYG --sql-mgmt-type Full --enable-r-services true

创建 SQL 虚拟机并配置自动备份设置。

az sql vm create -n sqlvm -g myresourcegroup -l eastus --license-type PAYG --sql-mgmt-type Full --backup-schedule-type manual --full-backup-frequency Weekly --full-backup-start-hour 2 --full-backup-duration 2 --sa-key {storageKey} --storage-account 'https://storageacc.blob.core.windows.net/' --retention-period 30 --log-backup-frequency 60

创建 SQL 虚拟机并配置自动修补设置。

az sql vm create -n sqlvm -g myresourcegroup -l eastus --license-type PAYG --sql-mgmt-type Full --day-of-week sunday --maintenance-window-duration 60 --maintenance-window-start-hour 2

创建 SQL 虚拟机并配置 SQL 连接设置。

az sql vm create -n sqlvm -g myresourcegroup -l eastus --license-type PAYG --sql-mgmt-type Full --connectivity-type private --port 1433 --sql-auth-update-username {newlogin} --sql-auth-update-pwd {sqlpassword}

必需参数

--name -n

SQL 虚拟机的名称。 新 SQL 虚拟机的名称必须与从 SQL 市场映像创建的基础虚拟机相等。

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name>配置默认组。

可选参数

以下参数是可选的,但根据上下文,命令可能需要一个或多个参数才能成功执行。

--backup-pwd

备份时加密的密码。

属性
参数组: Auto Backup Settings Arguments
--backup-schedule-type

备份计划类型。

属性
参数组: Auto Backup Settings Arguments
接受的值: Automated, Manual
--backup-system-dbs

在备份时包括系统数据库。

属性
参数组: Auto Backup Settings Arguments
默认值: False
接受的值: false, true
--connectivity-type

SQL Server 连接选项。

属性
参数组: SQL Connectivity Update Settings Arguments
接受的值: LOCAL, PRIVATE, PUBLIC
--credential-name

凭据名称。

属性
参数组: Key Vault Credential Settings Arguments
--day-of-week

应用修补程序的一周中的一天。

属性
参数组: Auto Patching Settings Arguments
接受的值: Everyday, Friday, Monday, Saturday, Sunday, Thursday, Tuesday, Wednesday
--enable-auto-backup

在 SQL 虚拟机上启用或禁用自动回退。 如果提供任何备份设置,参数会自动设置为 true。

属性
参数组: Auto Backup Settings Arguments
接受的值: false, true
--enable-auto-patching

在 SQL 虚拟机上启用或禁用自动修补。 如果提供任何自动修补设置,参数会自动设置为 true。

属性
参数组: Auto Patching Settings Arguments
接受的值: false, true
--enable-encryption

为 SQL 虚拟机上的备份启用加密。

属性
参数组: Auto Backup Settings Arguments
默认值: False
接受的值: false, true
--enable-key-vault-credential

启用或禁用密钥保管库凭据设置。 如果提供任何密钥保管库设置,参数会自动设置为 true。

属性
参数组: Key Vault Credential Settings Arguments
接受的值: false, true
--enable-r-services

启用或禁用 R 服务(SQL 2016 及更高版本)。

属性
参数组: Additional Features Arguments
接受的值: false, true
--full-backup-duration

给定日期的时间窗口的持续时间,在此期间可以进行完整备份。 1-23 小时。

属性
参数组: Auto Backup Settings Arguments
--full-backup-frequency

完整备份的频率。 在这两种情况下,完整备份将在下一个计划的时间范围内开始。

属性
参数组: Auto Backup Settings Arguments
接受的值: Daily, Weekly
--full-backup-start-hour

给定日期的开始时间,在此期间可以进行完整备份。 0-23 小时。

属性
参数组: Auto Backup Settings Arguments
--image-offer

SQL 映像产品/服务。 示例包括 SQL2008R2-WS2008、SQL2008-WS2008。

属性
参数组: SQL Server License Arguments
--image-sku

SQL 映像 SKU。

属性
参数组: SQL Server License Arguments
接受的值: Developer, Enterprise, Express, Standard, Web
--key-vault

Azure Key Vault URL。

属性
参数组: Key Vault Credential Settings Arguments
--least-privilege-mode

SQL IaaS 代理最低特权模式。 从 sysadmin 更新到每个功能使用的特定权限。

属性
接受的值: Enabled, NotSet
--license-type -i

SQL Server 许可证类型。

属性
参数组: SQL Server License Arguments
接受的值: AHUB, DR, PAYG
--location -l

Location. 如果未提供,虚拟机应位于资源组的同一区域。可以使用 az configure --defaults location=<location>配置默认位置。

--log-backup-frequency

日志备份的频率。 5-60 分钟。

属性
参数组: Auto Backup Settings Arguments
--maintenance-window-duration

修补的持续时间。 30-180 分钟。

属性
参数组: Auto Patching Settings Arguments
--maintenance-window-start-hour

开始修补的一天中的一小时。 本地 VM 时间 0-23 小时。

属性
参数组: Auto Patching Settings Arguments
--port

SQL Server 端口。

属性
参数组: SQL Connectivity Update Settings Arguments
--retention-period

备份的保留期。 1-30 天。

属性
参数组: Auto Backup Settings Arguments
--sa-key

将备份到的存储帐户密钥。

属性
参数组: Auto Backup Settings Arguments
--sp-name

用于访问密钥保管库的服务主体名称。

属性
参数组: Key Vault Credential Settings Arguments
--sp-secret

用于访问密钥保管库的服务主体名称机密。

属性
参数组: Key Vault Credential Settings Arguments
--sql-auth-update-pwd

SQL Server sysadmin 登录密码。

属性
参数组: SQL Connectivity Update Settings Arguments
--sql-auth-update-username

要创建的 SQL Server sysadmin 登录名。

属性
参数组: SQL Connectivity Update Settings Arguments
--sql-mgmt-type
已放弃

参数“sql_management_mode”已弃用,将在将来的版本中删除。

SQL Server 管理类型。 如果选择了 NoAgent,请提供 --image-sku 和 --offer-type。

属性
默认值: LightWeight
接受的值: Full, LightWeight, NoAgent
--sql-workload-type

SQL Server 工作负荷类型。

属性
参数组: SQL Workload Type Update Settings Arguments
接受的值: DW, GENERAL, OLTP
--storage-account

将备份到的存储帐户 URL。

属性
参数组: Auto Backup Settings Arguments
--tags

空格分隔标记:key[=value] [key[=value] ...]。使用“”清除现有标记。

全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

属性
默认值: False
--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误,禁止显示警告。

属性
默认值: False
--output -o

输出格式。

属性
默认值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

增加日志记录详细程度。 使用 --debug 获取完整的调试日志。

属性
默认值: False

az sql vm delete

删除 SQL 虚拟机。

az sql vm delete [--ids]
                 [--name]
                 [--resource-group]
                 [--subscription]
                 [--yes]

可选参数

以下参数是可选的,但根据上下文,命令可能需要一个或多个参数才能成功执行。

--ids

一个或多个资源 ID(以空格分隔)。 它应该是包含“Resource Id”参数的所有信息的完整资源 ID。 应提供 --ids 或其他“Resource Id”参数。

属性
参数组: Resource Id Arguments
--name -n

SQL 虚拟机的名称。

属性
参数组: Resource Id Arguments
--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name>配置默认组。

属性
参数组: Resource Id Arguments
--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

属性
参数组: Resource Id Arguments
--yes -y

不要提示确认。

属性
默认值: False
全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

属性
默认值: False
--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误,禁止显示警告。

属性
默认值: False
--output -o

输出格式。

属性
默认值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/

--verbose

增加日志记录详细程度。 使用 --debug 获取完整的调试日志。

属性
默认值: False

az sql vm enable-azure-ad-auth

启用 SQL 虚拟机的 Azure AD 身份验证。

az sql vm enable-azure-ad-auth [--ids]
                               [--msi-client-id]
                               [--name]
                               [--resource-group]
                               [--skip-client-validation]
                               [--subscription]

示例

使用客户端验证通过系统分配的托管标识启用 Azure AD 身份验证。

az sql vm enable-azure-ad-auth -n sqlvm -g myresourcegroup

使用客户端验证通过用户分配的托管标识启用 Azure AD 身份验证。

az sql vm enable-azure-ad-auth -n sqlvm -g myresourcegroup --msi-client-id 12345678

使用系统分配的托管标识来启用 Azure AD 身份验证,跳过客户端验证。 服务器端验证始终发生。

az sql vm enable-azure-ad-auth -n sqlvm -g myresourcegroup --skip-client-validation

使用用户分配的托管标识启用 Azure AD 身份验证,跳过客户端验证。 服务器端验证始终发生。

az sql vm enable-azure-ad-auth -n sqlvm -g myresourcegroup --msi-client-id 12345678 --skip-client-validation

可选参数

以下参数是可选的,但根据上下文,命令可能需要一个或多个参数才能成功执行。

--ids

一个或多个资源 ID(以空格分隔)。 它应该是包含“Resource Id”参数的所有信息的完整资源 ID。 应提供 --ids 或其他“Resource Id”参数。

属性
参数组: Resource Id Arguments
--msi-client-id

V 贝鲁特计算机托管标识客户端 ID。

--name -n

SQL 虚拟机的名称。

属性
参数组: Resource Id Arguments
--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name>配置默认组。

属性
参数组: Resource Id Arguments
--skip-client-validation

跳过客户端 Azure AD 身份验证验证,服务器端验证仍将发生。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

属性
参数组: Resource Id Arguments
全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

属性
默认值: False
--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误,禁止显示警告。

属性
默认值: False
--output -o

输出格式。

属性
默认值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/

--verbose

增加日志记录详细程度。 使用 --debug 获取完整的调试日志。

属性
默认值: False

az sql vm list

列出资源组或订阅中的所有 SQL 虚拟机。

az sql vm list [--resource-group]

可选参数

以下参数是可选的,但根据上下文,命令可能需要一个或多个参数才能成功执行。

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name>配置默认组。

全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

属性
默认值: False
--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误,禁止显示警告。

属性
默认值: False
--output -o

输出格式。

属性
默认值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

增加日志记录详细程度。 使用 --debug 获取完整的调试日志。

属性
默认值: False

az sql vm remove-from-group

从其当前 SQL 虚拟机组中删除 SQL 虚拟机。

az sql vm remove-from-group [--ids]
                            [--name]
                            [--resource-group]
                            [--subscription]

示例

从组中删除 SQL 虚拟机。

az sql vm remove-from-group -n sqlvm -g myresourcegroup

可选参数

以下参数是可选的,但根据上下文,命令可能需要一个或多个参数才能成功执行。

--ids

一个或多个资源 ID(以空格分隔)。 它应该是包含“Resource Id”参数的所有信息的完整资源 ID。 应提供 --ids 或其他“Resource Id”参数。

属性
参数组: Resource Id Arguments
--name -n

SQL 虚拟机的名称。

属性
参数组: Resource Id Arguments
--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name>配置默认组。

属性
参数组: Resource Id Arguments
--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

属性
参数组: Resource Id Arguments
全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

属性
默认值: False
--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误,禁止显示警告。

属性
默认值: False
--output -o

输出格式。

属性
默认值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/

--verbose

增加日志记录详细程度。 使用 --debug 获取完整的调试日志。

属性
默认值: False

az sql vm show

获取 SQL 虚拟机。

az sql vm show [--expand {*, AssessmentSettings, AutoBackupSettings, AutoPatchingSettings, KeyVaultCredentialSettings, ServerConfigurationsManagementSettings}]
               [--ids]
               [--name]
               [--resource-group]
               [--subscription]

可选参数

以下参数是可选的,但根据上下文,命令可能需要一个或多个参数才能成功执行。

--expand

获取 SQLIaaSExtension 配置设置。 若要查看所有设置,请使用 *。 若要仅选择几个设置,必须以空格分隔。

属性
接受的值: *, AssessmentSettings, AutoBackupSettings, AutoPatchingSettings, KeyVaultCredentialSettings, ServerConfigurationsManagementSettings
--ids

一个或多个资源 ID(以空格分隔)。 它应该是包含“Resource Id”参数的所有信息的完整资源 ID。 应提供 --ids 或其他“Resource Id”参数。

属性
参数组: Resource Id Arguments
--name -n

SQL 虚拟机的名称。

属性
参数组: Resource Id Arguments
--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name>配置默认组。

属性
参数组: Resource Id Arguments
--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

属性
参数组: Resource Id Arguments
全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

属性
默认值: False
--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误,禁止显示警告。

属性
默认值: False
--output -o

输出格式。

属性
默认值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/

--verbose

增加日志记录详细程度。 使用 --debug 获取完整的调试日志。

属性
默认值: False

az sql vm start-assessment

在 SQL 虚拟机上启动 SQL 最佳做法评估。

az sql vm start-assessment [--ids]
                           [--name]
                           [--resource-group]
                           [--subscription]

示例

启动 SQL 最佳做法评估。

az sql vm start-assessment -n sqlvm -g myresourcegroup

可选参数

以下参数是可选的,但根据上下文,命令可能需要一个或多个参数才能成功执行。

--ids

一个或多个资源 ID(以空格分隔)。 它应该是包含“Resource Id”参数的所有信息的完整资源 ID。 应提供 --ids 或其他“Resource Id”参数。

属性
参数组: Resource Id Arguments
--name -n

SQL 虚拟机的名称。

属性
参数组: Resource Id Arguments
--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name>配置默认组。

属性
参数组: Resource Id Arguments
--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

属性
参数组: Resource Id Arguments
全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

属性
默认值: False
--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误,禁止显示警告。

属性
默认值: False
--output -o

输出格式。

属性
默认值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/

--verbose

增加日志记录详细程度。 使用 --debug 获取完整的调试日志。

属性
默认值: False

az sql vm update

更新 SQL 虚拟机的属性。

az sql vm update [--add]
                 [--agent-rg]
                 [--am-day --assessment-day-of-week {Friday, Monday, Saturday, Sunday, Thursday, Tuesday, Wednesday}]
                 [--am-month-occ --assessment-monthly-occurrence {-1, 1, 2, 3, 4}]
                 [--am-schedule --enable-assessment-schedule {false, true}]
                 [--am-time --assessment-start-time-local]
                 [--am-week-int --assessment-weekly-interval {1, 2, 3, 4, 5, 6}]
                 [--backup-pwd]
                 [--backup-schedule-type {Automated, Manual}]
                 [--backup-system-dbs {false, true}]
                 [--connectivity-type {LOCAL, PRIVATE, PUBLIC}]
                 [--credential-name]
                 [--day-of-week {Everyday, Friday, Monday, Saturday, Sunday, Thursday, Tuesday, Wednesday}]
                 [--enable-assessment {false, true}]
                 [--enable-auto-backup {false, true}]
                 [--enable-auto-patching {false, true}]
                 [--enable-encryption {false, true}]
                 [--enable-key-vault-credential {false, true}]
                 [--enable-r-services {false, true}]
                 [--force-string]
                 [--full-backup-duration]
                 [--full-backup-frequency {Daily, Weekly}]
                 [--full-backup-start-hour]
                 [--ids]
                 [--image-sku {Developer, Enterprise, Express, Standard, Web}]
                 [--key-vault]
                 [--least-privilege-mode {Enabled, NotSet}]
                 [--license-type {AHUB, DR, PAYG}]
                 [--log-backup-frequency]
                 [--maintenance-window-duration]
                 [--maintenance-window-start-hour]
                 [--name]
                 [--port]
                 [--remove]
                 [--resource-group]
                 [--retention-period]
                 [--sa-key]
                 [--set]
                 [--sp-name]
                 [--sp-secret]
                 [--sql-mgmt-type {Full, LightWeight, NoAgent}]
                 [--sql-workload-type {DW, GENERAL, OLTP}]
                 [--storage-account]
                 [--subscription]
                 [--tags]
                 [--workspace-name]
                 [--workspace-rg]
                 [--workspace-sub]
                 [--yes]

示例

添加或更新标记。

az sql vm update -n sqlvm -g myresourcegroup --set tags.tagName=tagValue

删除标记。

az sql vm update -n sqlvm -g myresourcegroup --remove tags.tagName

使用特定 SKU 类型更新 SQL 虚拟机。

az sql vm update -n sqlvm -g myresourcegroup --image-sku Enterprise

将 SQL 虚拟机可管理性从 LightWeight 更新为 Full。

az sql vm update -n sqlvm -g myresourcegroup --sql-mgmt-type Full

将 SQL 虚拟机更新为最低特权模式。

az sql vm update -n sqlvm -g myresourcegroup --least-privilege-mode Enabled --sql-mgmt-type Full

更新 SQL 虚拟机自动备份设置。

az sql vm update -n sqlvm -g myresourcegroup --backup-schedule-type manual --full-backup-frequency Weekly --full-backup-start-hour 2 --full-backup-duration 2 --sa-key {storageKey} --storage-account 'https://storageacc.blob.core.windows.net/' --retention-period 30 --log-backup-frequency 60

禁用 SQL 虚拟机自动备份设置。

az sql vm update -n sqlvm -g myresourcegroup --enable-auto-backup false

更新 SQL 虚拟机自动修补设置。

az sql vm update -n sqlvm -g myresourcegroup --day-of-week sunday --maintenance-window-duration 60 --maintenance-window-start-hour 2

禁用 SQL 虚拟机自动修补设置。

az sql vm update -n sqlvm -g myresourcegroup --enable-auto-patching false

将 SQL 虚拟机计费标记更新为 AHUB。

az sql vm update -n sqlvm -g myresourcegroup --license-type AHUB

将 SQL 虚拟机计费标记更新为 DR。

az sql vm update -n sqlvm -g myresourcegroup --license-type DR

更新 SQL 虚拟机以禁用 SQL 最佳做法评估。

az sql vm update -n sqlvm -g myresourcegroup --enable-assessment false

更新 SQL 虚拟机以禁用 SQL 最佳做法评估的计划。

az sql vm update -n sqlvm -g myresourcegroup --enable-assessment-schedule false

更新 SQL 虚拟机,以便在 VM 已与 Log Analytics 工作区关联时,按每周间隔启用 SQL 最佳做法评估计划。

az sql vm update -n sqlvm -g myresourcegroup --assessment-weekly-interval 1 --assessment-day-of-week monday --assessment-start-time-local '19:30'

更新 SQL 虚拟机,以便在与 Log Analytics 工作区关联并为代理资源分配资源组时启用按月进行 SQL 最佳做法评估的计划。

az sql vm update -n sqlvm -g myresourcegroup --workspace-name myLogAnalyticsWorkspace --workspace-rg myRg --agent-rg myRg2 --assessment-monthly-occurrence 1 --assessment-day-of-week monday --assessment-start-time-local '19:30'

更新 SQL 虚拟机以启用 SQL 最佳做法评估,而无需设置按需运行评估的计划。 必须提供 Log Analytics 工作区和用于部署代理资源的资源组。

az sql vm update -n sqlvm -g myresourcegroup --enable-assessment true --workspace-name myLogAnalyticsWorkspace --workspace-rg myRg --agent-rg myRg2

更新 SQL 虚拟机,以便在将不同订阅中的 Log Analytics 工作区关联时启用 SQL 最佳做法评估

az sql vm update -n sqlvm -g myresourcegroup --enable-assessment true --workspace-name myLogAnalyticsWorkspace --workspace-rg myRg --workspace-sub myLogAnalyticsWorkspaceSubName --agent-rg myRg2

可选参数

以下参数是可选的,但根据上下文,命令可能需要一个或多个参数才能成功执行。

--add

通过指定路径和键值对将对象添加到对象列表。 示例:--add property.listProperty <key=value, string or JSON string>

属性
参数组: Generic Update Arguments
默认值: []
--agent-rg

包含 AMA 资源 DCE 和 DCR 的资源组。

属性
参数组: Assessment Settings Arguments
--am-day --assessment-day-of-week

运行评估的一周中的一天。

属性
参数组: Assessment Settings Arguments
接受的值: Friday, Monday, Saturday, Sunday, Thursday, Tuesday, Wednesday
--am-month-occ --assessment-monthly-occurrence

在一个月内发生 DayOfWeek 日期以安排评估。 支持值 1,2,3,4 和 -1。 将 -1 用于月份的最后一天OfWeek 日(例如, 本月的最后一个星期二)。

属性
参数组: Assessment Settings Arguments
接受的值: -1, 1, 2, 3, 4
--am-schedule --enable-assessment-schedule

启用或禁用评估计划。 如果提供任何评估计划设置,参数会自动设置为 true。

属性
参数组: Assessment Settings Arguments
接受的值: false, true
--am-time --assessment-start-time-local

以 HH:mm 格式表示的一天时间。 示例包括 17:30、05:13。

属性
参数组: Assessment Settings Arguments
--am-week-int --assessment-weekly-interval

计划 2 个评估运行之间的周数。 支持 1-6 的值。

属性
参数组: Assessment Settings Arguments
接受的值: 1, 2, 3, 4, 5, 6
--backup-pwd

备份时加密的密码。

属性
参数组: Auto Backup Settings Arguments
--backup-schedule-type

备份计划类型。

属性
参数组: Auto Backup Settings Arguments
接受的值: Automated, Manual
--backup-system-dbs

在备份时包括系统数据库。

属性
参数组: Auto Backup Settings Arguments
默认值: False
接受的值: false, true
--connectivity-type

SQL Server 连接选项。

属性
参数组: SQL Connectivity Update Settings Arguments
接受的值: LOCAL, PRIVATE, PUBLIC
--credential-name

凭据名称。

属性
参数组: Key Vault Credential Settings Arguments
--day-of-week

应用修补程序的一周中的一天。

属性
参数组: Auto Patching Settings Arguments
接受的值: Everyday, Friday, Monday, Saturday, Sunday, Thursday, Tuesday, Wednesday
--enable-assessment

启用或禁用评估功能。 如果提供任何评估设置,参数会自动设置为 true。

属性
参数组: Assessment Settings Arguments
接受的值: false, true
--enable-auto-backup

在 SQL 虚拟机上启用或禁用自动回退。 如果提供任何备份设置,参数会自动设置为 true。

属性
参数组: Auto Backup Settings Arguments
接受的值: false, true
--enable-auto-patching

在 SQL 虚拟机上启用或禁用自动修补。 如果提供任何自动修补设置,参数会自动设置为 true。

属性
参数组: Auto Patching Settings Arguments
接受的值: false, true
--enable-encryption

为 SQL 虚拟机上的备份启用加密。

属性
参数组: Auto Backup Settings Arguments
默认值: False
接受的值: false, true
--enable-key-vault-credential

启用或禁用密钥保管库凭据设置。 如果提供任何密钥保管库设置,参数会自动设置为 true。

属性
参数组: Key Vault Credential Settings Arguments
接受的值: false, true
--enable-r-services

启用或禁用 R 服务(SQL 2016 及更高版本)。

属性
参数组: Additional Features Arguments
接受的值: false, true
--force-string

使用“set”或“add”时,保留字符串文本,而不是尝试转换为 JSON。

属性
参数组: Generic Update Arguments
默认值: False
--full-backup-duration

给定日期的时间窗口的持续时间,在此期间可以进行完整备份。 1-23 小时。

属性
参数组: Auto Backup Settings Arguments
--full-backup-frequency

完整备份的频率。 在这两种情况下,完整备份将在下一个计划的时间范围内开始。

属性
参数组: Auto Backup Settings Arguments
接受的值: Daily, Weekly
--full-backup-start-hour

给定日期的开始时间,在此期间可以进行完整备份。 0-23 小时。

属性
参数组: Auto Backup Settings Arguments
--ids

一个或多个资源 ID(以空格分隔)。 它应该是包含“Resource Id”参数的所有信息的完整资源 ID。 应提供 --ids 或其他“Resource Id”参数。

属性
参数组: Resource Id Arguments
--image-sku

SQL 映像 SKU。

属性
参数组: SQL Server License Arguments
接受的值: Developer, Enterprise, Express, Standard, Web
--key-vault

Azure Key Vault URL。

属性
参数组: Key Vault Credential Settings Arguments
--least-privilege-mode

SQL IaaS 代理最低特权模式。 从 sysadmin 更新到每个功能使用的特定权限。

属性
接受的值: Enabled, NotSet
--license-type -i

SQL Server 许可证类型。

属性
参数组: SQL Server License Arguments
接受的值: AHUB, DR, PAYG
--log-backup-frequency

日志备份的频率。 5-60 分钟。

属性
参数组: Auto Backup Settings Arguments
--maintenance-window-duration

修补的持续时间。 30-180 分钟。

属性
参数组: Auto Patching Settings Arguments
--maintenance-window-start-hour

开始修补的一天中的一小时。 本地 VM 时间 0-23 小时。

属性
参数组: Auto Patching Settings Arguments
--name -n

SQL 虚拟机的名称。

属性
参数组: Resource Id Arguments
--port

SQL Server 端口。

属性
参数组: SQL Connectivity Update Settings Arguments
--remove

从列表中删除属性或元素。 示例: --remove property.list <indexToRemove> OR --remove propertyToRemove.

属性
参数组: Generic Update Arguments
默认值: []
--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name>配置默认组。

属性
参数组: Resource Id Arguments
--retention-period

备份的保留期。 1-30 天。

属性
参数组: Auto Backup Settings Arguments
--sa-key

将备份到的存储帐户密钥。

属性
参数组: Auto Backup Settings Arguments
--set

通过指定要设置的属性路径和值来更新对象。 示例:--set property1.property2=<value>

属性
参数组: Generic Update Arguments
默认值: []
--sp-name

用于访问密钥保管库的服务主体名称。

属性
参数组: Key Vault Credential Settings Arguments
--sp-secret

用于访问密钥保管库的服务主体名称机密。

属性
参数组: Key Vault Credential Settings Arguments
--sql-mgmt-type
已放弃

参数“sql_management_mode”已弃用,将在将来的版本中删除。

SQL Server 管理类型。 从 LightWeight 更新到完整版。

属性
接受的值: Full, LightWeight, NoAgent
--sql-workload-type

SQL Server 工作负荷类型。

属性
参数组: SQL Workload Type Update Settings Arguments
接受的值: DW, GENERAL, OLTP
--storage-account

将备份到的存储帐户 URL。

属性
参数组: Auto Backup Settings Arguments
--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

属性
参数组: Resource Id Arguments
--tags

空格分隔标记:key[=value] [key[=value] ...]。使用“”清除现有标记。

--workspace-name

要与 VM 关联的 Log Analytics 工作区的名称。

属性
参数组: Assessment Settings Arguments
--workspace-rg

包含 Log Analytics 工作区的资源组。

属性
参数组: Assessment Settings Arguments
--workspace-sub

包含 Log Analytics 工作区的订阅。

属性
参数组: Assessment Settings Arguments
--yes -y
已放弃

参数“prompt”已弃用,将在将来的版本中删除。

不要提示确认。 需要 --sql-mgmt-type。

属性
默认值: True
全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

属性
默认值: False
--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误,禁止显示警告。

属性
默认值: False
--output -o

输出格式。

属性
默认值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/

--verbose

增加日志记录详细程度。 使用 --debug 获取完整的调试日志。

属性
默认值: False

az sql vm validate-azure-ad-auth

在客户端验证 SQL 虚拟机的 Azure AD 身份验证,而无需启用它。

az sql vm validate-azure-ad-auth [--ids]
                                 [--msi-client-id]
                                 [--name]
                                 [--resource-group]
                                 [--subscription]

示例

在客户端使用系统分配的托管标识验证 Azure AD 身份验证。

az sql vm validate-azure-ad-auth -n sqlvm -g myresourcegroup

在客户端使用用户分配的托管标识验证 Azure AD 身份验证。

az sql vm validate-azure-ad-auth -n sqlvm -g myresourcegroup --msi-client-id 12345678

可选参数

以下参数是可选的,但根据上下文,命令可能需要一个或多个参数才能成功执行。

--ids

一个或多个资源 ID(以空格分隔)。 它应该是包含“Resource Id”参数的所有信息的完整资源 ID。 应提供 --ids 或其他“Resource Id”参数。

属性
参数组: Resource Id Arguments
--msi-client-id

V 贝鲁特计算机托管标识客户端 ID。

--name -n

SQL 虚拟机的名称。

属性
参数组: Resource Id Arguments
--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name>配置默认组。

属性
参数组: Resource Id Arguments
--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

属性
参数组: Resource Id Arguments
全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

属性
默认值: False
--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误,禁止显示警告。

属性
默认值: False
--output -o

输出格式。

属性
默认值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/

--verbose

增加日志记录详细程度。 使用 --debug 获取完整的调试日志。

属性
默认值: False