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

az sql vm

管理 SQL 虚拟机。

命令

名称	说明	类型	状态
az sql vm add-to-group	将 SQL 虚拟机添加到 SQL 虚拟机组。	核心	GA
az sql vm create	创建 SQL 虚拟机。	核心	GA
az sql vm delete	删除 SQL 虚拟机。	核心	GA
az sql vm enable-azure-ad-auth	启用 SQL 虚拟机的 Azure AD 身份验证。	核心	GA
az sql vm group	管理 SQL 虚拟机组。	核心	GA
az sql vm group ag-listener	管理 SQL 可用性组侦听程序。	核心	GA
az sql vm group ag-listener create	创建可用性组侦听器。	核心	GA
az sql vm group ag-listener delete	删除可用性组侦听器。	核心	GA
az sql vm group ag-listener list	列出 SQL 虚拟机组中的所有可用性组侦听器。	核心	GA
az sql vm group ag-listener show	获取可用性组侦听器。	核心	GA
az sql vm group ag-listener update	汇报可用性组侦听器。	核心	GA
az sql vm group create	创建 SQL 虚拟机组。	核心	GA
az sql vm group delete	删除 SQL 虚拟机组。	核心	GA
az sql vm group list	列出资源组或订阅中的所有 SQL 虚拟机组。	核心	GA
az sql vm group show	获取 SQL 虚拟机组。	核心	GA
az sql vm group update	如果没有附加到该组的 SQL 虚拟机，汇报 SQL 虚拟机组。	核心	GA
az sql vm list	列出资源组或订阅中的所有 SQL 虚拟机。	核心	GA
az sql vm remove-from-group	从其当前 SQL 虚拟机组中删除 SQL 虚拟机。	核心	GA
az sql vm show	获取 SQL 虚拟机。	核心	GA
az sql vm start-assessment	在 SQL 虚拟机上启动 SQL 最佳做法评估。	核心	GA
az sql vm update	汇报 SQL 虚拟机的属性。	核心	GA
az sql vm validate-azure-ad-auth	在客户端验证 SQL 虚拟机的 Azure AD 身份验证，而无需启用它。	核心	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 虚拟机组中提供群集启动帐户的密码。

--ids

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

--name -n

SQL 虚拟机的名称。

--operator-acc-pwd -p

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

--resource-group -g

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

--service-acc-pwd -s

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

--subscription

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

全局参数

--debug

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

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

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

--subscription

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

--verbose

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

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

备份时加密的密码。

--backup-schedule-type

备份计划类型。

接受的值: Automated, Manual

--backup-system-dbs

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

接受的值: false, true

默认值: False

--connectivity-type

SQL Server 连接选项。

接受的值: LOCAL, PRIVATE, PUBLIC

--credential-name

凭据名称。

--day-of-week

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

接受的值: Everyday, Friday, Monday, Saturday, Sunday, Thursday, Tuesday, Wednesday

--enable-auto-backup

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

接受的值: false, true

--enable-auto-patching

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

接受的值: false, true

--enable-encryption

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

接受的值: false, true

默认值: False

--enable-key-vault-credential

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

接受的值: false, true

--enable-r-services

启用或禁用 R 服务（SQL 2016 及更高版本）。

接受的值: false, true

--full-backup-duration

在给定的日期可以执行完整备份的时段持续时间。 1-23 小时。

--full-backup-frequency

完整备份的频率。 上述两种情况下，均在下一个计划的时间段内开始完整备份。

接受的值: Daily, Weekly

--full-backup-start-hour

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

--image-offer

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

--image-sku

SQL 映像 SKU。

接受的值: Developer, Enterprise, Express, Standard, Web

--key-vault

Azure 密钥库 URL。

--least-privilege-mode

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

接受的值: Enabled, NotSet

--license-type -i

SQL Server 许可证类型。

接受的值: AHUB, DR, PAYG

--location -l

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

--log-backup-frequency

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

--maintenance-window-duration

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

--maintenance-window-start-hour

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

--port

SQL Server 端口。

--retention-period

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

--sa-key

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

--sp-name

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

--sp-secret

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

--sql-auth-update-pwd

SQL Server sysadmin 登录密码。

--sql-auth-update-username

要创建的 SQL Server sysadmin 登录名。

--sql-mgmt-type

已放弃

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

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

接受的值: Full, LightWeight, NoAgent

默认值: LightWeight

--sql-workload-type

SQL Server 工作负荷类型。

接受的值: DW, GENERAL, OLTP

--storage-account

存储将备份到的帐户 URL。

--tags

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

全局参数

--debug

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

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

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

--subscription

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

--verbose

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

az sql vm delete

删除 SQL 虚拟机。

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

可选参数

--ids

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

--name -n

SQL 虚拟机的名称。

--resource-group -g

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

--subscription

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

--yes -y

不提示确认。

默认值: False

全局参数

--debug

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

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

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

--subscription

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

--verbose

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

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（以空格分隔）。 它应该是包含“资源 ID”参数的所有信息的完整资源 ID。 应提供 --id 或其他“资源 ID”参数。

--msi-client-id

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

--name -n

SQL 虚拟机的名称。

--resource-group -g

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

--skip-client-validation

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

--subscription

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

全局参数

--debug

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

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

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

--subscription

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

--verbose

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

az sql vm list

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

az sql vm list [--resource-group]

可选参数

--resource-group -g

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

全局参数

--debug

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

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

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

--subscription

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

--verbose

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

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（以空格分隔）。 它应该是包含“资源 ID”参数的所有信息的完整资源 ID。 应提供 --id 或其他“资源 ID”参数。

--name -n

SQL 虚拟机的名称。

--resource-group -g

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

--subscription

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

全局参数

--debug

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

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

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

--subscription

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

--verbose

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

az sql vm show

获取 SQL 虚拟机。

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

可选参数

--expand

获取 SQLIaa标准版xtension 配置设置。 若要查看所有设置，请使用 *。 若要仅选择几个设置，必须以空格分隔。

接受的值: *, AssessmentSettings, AutoBackupSettings, AutoPatchingSettings, KeyVaultCredentialSettings, ServerConfigurationsManagementSettings

--ids

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

--name -n

SQL 虚拟机的名称。

--resource-group -g

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

--subscription

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

全局参数

--debug

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

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

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

--subscription

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

--verbose

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

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（以空格分隔）。 它应该是包含“资源 ID”参数的所有信息的完整资源 ID。 应提供 --id 或其他“资源 ID”参数。

--name -n

SQL 虚拟机的名称。

--resource-group -g

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

--subscription

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

全局参数

--debug

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

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

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

--subscription

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

--verbose

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

az sql vm update

汇报 SQL 虚拟机的属性。

az sql vm update [--add]
                 [--agent-rg]
                 [--am-day {Friday, Monday, Saturday, Sunday, Thursday, Tuesday, Wednesday}]
                 [--am-month-occ {-1, 1, 2, 3, 4}]
                 [--am-schedule {false, true}]
                 [--am-time]
                 [--am-week-int {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>。

默认值: []

--agent-rg

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

--am-day --assessment-day-of-week

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

接受的值: Friday, Monday, Saturday, Sunday, Thursday, Tuesday, Wednesday

--am-month-occ --assessment-monthly-occurrence

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

接受的值: -1, 1, 2, 3, 4

--am-schedule --enable-assessment-schedule

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

接受的值: false, true

--am-time --assessment-start-time-local

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

--am-week-int --assessment-weekly-interval

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

接受的值: 1, 2, 3, 4, 5, 6

--backup-pwd

备份时加密的密码。

--backup-schedule-type

备份计划类型。

接受的值: Automated, Manual

--backup-system-dbs

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

接受的值: false, true

默认值: False

--connectivity-type

SQL Server 连接选项。

接受的值: LOCAL, PRIVATE, PUBLIC

--credential-name

凭据名称。

--day-of-week

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

接受的值: Everyday, Friday, Monday, Saturday, Sunday, Thursday, Tuesday, Wednesday

--enable-assessment

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

接受的值: false, true

--enable-auto-backup

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

接受的值: false, true

--enable-auto-patching

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

接受的值: false, true

--enable-encryption

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

接受的值: false, true

默认值: False

--enable-key-vault-credential

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

接受的值: false, true

--enable-r-services

启用或禁用 R 服务（SQL 2016 及更高版本）。

接受的值: false, true

--force-string

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

默认值: False

--full-backup-duration

在给定的日期可以执行完整备份的时段持续时间。 1-23 小时。

--full-backup-frequency

完整备份的频率。 上述两种情况下，均在下一个计划的时间段内开始完整备份。

接受的值: Daily, Weekly

--full-backup-start-hour

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

--ids

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

--image-sku

SQL 映像 SKU。

接受的值: Developer, Enterprise, Express, Standard, Web

--key-vault

Azure 密钥库 URL。

--least-privilege-mode

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

接受的值: Enabled, NotSet

--license-type -i

SQL Server 许可证类型。

接受的值: AHUB, DR, PAYG

--log-backup-frequency

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

--maintenance-window-duration

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

--maintenance-window-start-hour

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

--name -n

SQL 虚拟机的名称。

--port

SQL Server 端口。

--remove

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

默认值: []

--resource-group -g

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

--retention-period

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

--sa-key

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

--set

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

默认值: []

--sp-name

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

--sp-secret

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

--sql-mgmt-type

已放弃

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

SQL Server 管理类型。 从 LightWeight 到 Full 汇报。

接受的值: Full, LightWeight, NoAgent

--sql-workload-type

SQL Server 工作负荷类型。

接受的值: DW, GENERAL, OLTP

--storage-account

存储将备份到的帐户 URL。

--subscription

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

--tags

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

--workspace-name

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

--workspace-rg

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

--workspace-sub

包含 Log Analytics 工作区的订阅。

--yes -y

已放弃

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

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

默认值: True

全局参数

--debug

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

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

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

--subscription

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

--verbose

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

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（以空格分隔）。 它应该是包含“资源 ID”参数的所有信息的完整资源 ID。 应提供 --id 或其他“资源 ID”参数。

--msi-client-id

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

--name -n

SQL 虚拟机的名称。

--resource-group -g

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

--subscription

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

全局参数

--debug

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

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

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

--subscription

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

--verbose

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