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

az sql mi

参考

管理 SQL 托管实例。

命令

名称	说明	类型	Status
az sql mi ad-admin	管理托管实例的 Active Directory 管理员。	核心	GA
az sql mi ad-admin create	创建新的托管实例 Active Directory 管理员。	核心	GA
az sql mi ad-admin delete	删除现有托管实例 Active Directory 管理员。	核心	GA
az sql mi ad-admin list	返回托管实例 Active Directory 管理员的列表。	核心	GA
az sql mi ad-admin update	更新现有托管实例 Active Directory 管理员。	核心	GA
az sql mi ad-only-auth	管理托管实例的仅限 Azure Active Directory 设置。	核心	GA
az sql mi ad-only-auth disable	为此托管实例禁用 Azure Active Directory 身份验证。	核心	GA
az sql mi ad-only-auth enable	为此托管实例启用仅限 Azure Active Directory 身份验证。	核心	GA
az sql mi ad-only-auth get	获取特定的 Azure Active Directory 仅身份验证属性。	核心	GA
az sql mi advanced-threat-protection-setting	管理SQL 托管实例的高级威胁防护设置。	核心	GA
az sql mi advanced-threat-protection-setting show	获取高级威胁防护设置。	核心	GA
az sql mi advanced-threat-protection-setting update	更新SQL 托管实例的高级威胁防护设置。	核心	GA
az sql mi create	创建托管实例。	核心	GA
az sql mi delete	删除托管实例。	核心	GA
az sql mi dtc	与托管实例 DTC 管理相关的命令。	核心	GA
az sql mi dtc show	获取托管实例 DTC 设置。	核心	GA
az sql mi dtc update	更新托管实例 DTC 设置。	核心	GA
az sql mi dtc wait	将 CLI 置于等待状态，直到满足条件。	核心	GA
az sql mi endpoint-cert	终结点证书管理命令。	核心	GA
az sql mi endpoint-cert list	列出目标实例上终结点上使用的证书。	核心	GA
az sql mi endpoint-cert show	获取在具有给定 ID 的终结点上使用的证书。	核心	GA
az sql mi failover	故障转移托管实例。	核心	GA
az sql mi key	管理 SQL 实例的密钥。	核心	GA
az sql mi key create	创建 SQL 实例密钥。	核心	GA
az sql mi key delete	删除 SQL 实例密钥。	核心	GA
az sql mi key list	获取托管实例密钥的列表。	核心	GA
az sql mi key show	显示 SQL 实例密钥。	核心	GA
az sql mi link	实例链接管理命令。	核心	GA
az sql mi link create	创建新的实例链接。	核心	GA
az sql mi link delete	删除实例链接。	核心	GA
az sql mi link list	返回有关Azure SQL 托管实例的链接功能的信息。	核心	GA
az sql mi link show	返回有关Azure SQL 托管实例的链接功能的信息。	核心	GA
az sql mi link update	更新实例链接的属性。	核心	GA
az sql mi list	列出可用的托管实例。	核心	GA
az sql mi op	管理托管实例上的操作。	核心	GA
az sql mi op cancel	取消托管实例上的异步操作。	核心	GA
az sql mi op list	获取在托管实例上执行的操作的列表。	核心	GA
az sql mi op show	获取托管实例上的管理操作。	核心	GA
az sql mi partner-cert	服务器信任证书管理命令。	核心	GA
az sql mi partner-cert create	将服务器信任证书从框上传到 Sql 托管实例。	核心	GA
az sql mi partner-cert delete	删除从框中上传到 Sql 托管实例的服务器信任证书。	核心	GA
az sql mi partner-cert list	获取从框中上传到给定 Sql 托管实例的服务器信任证书的列表。	核心	GA
az sql mi partner-cert show	获取从框中上传到 Sql 托管实例的服务器信任证书。	核心	GA
az sql mi refresh-external-governance-status	刷新外部治理启用状态。	核心	GA
az sql mi server-configuration-option	服务器配置选项管理命令。	核心	GA
az sql mi server-configuration-option list	列出托管实例服务器配置选项的列表。	核心	GA
az sql mi server-configuration-option set	设置托管实例服务器配置选项。	核心	GA
az sql mi server-configuration-option show	获取托管实例服务器配置选项。	核心	GA
az sql mi server-configuration-option wait	将 CLI 置于等待状态，直到满足条件。	核心	GA
az sql mi show	获取托管实例的详细信息。	核心	GA
az sql mi start	启动托管实例。	核心	GA
az sql mi start-stop-schedule	管理托管实例的启动停止计划。	核心	GA
az sql mi start-stop-schedule create	创建托管实例的启动/停止计划。	核心	GA
az sql mi start-stop-schedule delete	删除托管实例的启动/停止计划。	核心	GA
az sql mi start-stop-schedule list	列出托管实例的“启动/停止”计划。	核心	GA
az sql mi start-stop-schedule show	获取托管实例的启动/停止计划。	核心	GA
az sql mi start-stop-schedule update	更新托管实例的启动/停止计划。	核心	GA
az sql mi stop	停止托管实例。	核心	GA
az sql mi tde-key	管理 SQL 实例的加密保护程序。	核心	GA
az sql mi tde-key set	设置 SQL 实例的加密保护程序。	核心	GA
az sql mi tde-key show	显示服务器加密保护程序。	核心	GA
az sql mi update	更新托管实例。	核心	GA

az sql mi create

编辑

创建托管实例。

az sql mi create --name
                 --resource-group
                 --subnet
                 [--admin-password]
                 [--admin-user]
                 [--assign-identity]
                 [--backup-storage-redundancy]
                 [--capacity]
                 [--collation]
                 [--database-format {AlwaysUpToDate, SQLServer2022}]
                 [--dns-zone-partner]
                 [--edition]
                 [--enable-ad-only-auth]
                 [--external-admin-name]
                 [--external-admin-principal-type]
                 [--external-admin-sid]
                 [--family]
                 [--identity-type {None, SystemAssigned, SystemAssigned,UserAssigned, UserAssigned}]
                 [--instance-pool-name]
                 [--key-id]
                 [--license-type {BasePrice, LicenseIncluded}]
                 [--location]
                 [--maint-config-id]
                 [--minimal-tls-version {1.0, 1.1, 1.2, None}]
                 [--no-wait]
                 [--pid]
                 [--pricing-model {Freemium, Regular}]
                 [--proxy-override {Default, Proxy, Redirect}]
                 [--public-data-endpoint-enabled {false, true}]
                 [--service-principal-type {None, SystemAssigned}]
                 [--storage]
                 [--tags]
                 [--timezone-id]
                 [--user-assigned-identity-id]
                 [--vnet-name]
                 [--yes]
                 [--zone-redundant {false, true}]

示例

使用最少的参数集创建托管实例

az sql mi create -g mygroup -n myinstance -l mylocation -i -u myusername -p mypassword --subnet /subscriptions/{SubID}/resourceGroups/{ResourceGroup}/providers/Microsoft.Network/virtualNetworks/{VNETName}/subnets/{SubnetName}

使用指定的参数和标识创建托管实例

az sql mi create -g mygroup -n myinstance -l mylocation -i -u myusername -p mypassword --license-type LicenseIncluded --subnet /subscriptions/{SubID}/resourceGroups/{ResourceGroup}/providers/Microsoft.Network/virtualNetworks/{VNETName}/subnets/{SubnetName} --capacity 8 --storage 32GB --edition GeneralPurpose --family Gen5

使用指定的参数和标记创建托管实例

az sql mi create -g mygroup -n myinstance -l mylocation -i -u myusername -p mypassword --license-type LicenseIncluded --subnet /subscriptions/{SubID}/resourceGroups/{ResourceGroup}/providers/Microsoft.Network/virtualNetworks/{VNETName}/subnets/{SubnetName} --capacity 8 --storage 32GB --edition GeneralPurpose --family Gen5 --tags tagName1=tagValue1 tagName2=tagValue2

使用指定的参数和备份存储冗余创建托管实例

az sql mi create -g mygroup -n myinstance -l mylocation -i -u myusername -p mypassword --license-type LicenseIncluded --subnet /subscriptions/{SubID}/resourceGroups/{ResourceGroup}/providers/Microsoft.Network/virtualNetworks/{VNETName}/subnets/{SubnetName} --capacity 8 --storage 32GB --edition GeneralPurpose --family Gen5 --backup-storage-redundancy Local

使用维护配置创建托管实例

az sql mi create -g mygroup -n myinstance -l mylocation -i -u myusername -p mypassword --subnet /subscriptions/{SubID}/resourceGroups/{ResourceGroup}/providers/Microsoft.Network/virtualNetworks/{VNETName}/subnets/{SubnetName} -m SQL_{Region}_{MaintenanceConfigName}

创建启用了服务主体的托管实例

az sql mi create -g mygroup -n myinstance -l mylocation -i -u myusername -p mypassword --subnet /subscriptions/{SubID}/resourceGroups/{ResourceGroup}/providers/Microsoft.Network/virtualNetworks/{VNETName}/subnets/{SubnetName} --service-principal-type SystemAssigned

在没有 SQL 管理员的情况下创建托管实例，并启用 AAD 管理员和仅限 AD

az sql mi create --enable-ad-only-auth --external-admin-principal-type User --external-admin-name myUserName --external-admin-sid c5e964e2-6bb2-2222-1111-3b16ec0e1234 -g myResourceGroup -n miName --subnet /subscriptions/78975f9f-2222-1111-1111-29c42ac70000/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/vnet-test/subnets/ManagedInstance

创建没有 SQL 管理员的托管实例，并启用 AD 管理员，仅启用 AD，用户 ManagedIdenties 和标识类型为 SystemAssigned，UserAssigned。

az sql mi create --enable-ad-only-auth --external-admin-principal-type User --external-admin-name myUserName \ --external-admin-sid c5e964e2-6bb2-1111-1111-3b16ec0e1234 -g myResourceGroup -n myServer -i \ --user-assigned-identity-id /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/testumi \ --identity-type SystemAssigned,UserAssigned --pid /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/testumi \ --subnet /subscriptions/78975f9f-2222-1111-1111-29c42ac70000/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/vnet-test/subnets/ManagedInstance

在没有 SQL 管理员的情况下创建托管实例，并启用 AD 管理员、仅启用 AD、用户 ManagedIdenties 和标识类型为 UserAssigned。

az sql mi create --enable-ad-only-auth --external-admin-principal-type User --external-admin-name myUserName \ --external-admin-sid c5e964e2-6bb2-1111-1111-3b16ec0e1234 -g myResourceGroup -n myServer -i \ --user-assigned-identity-id /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/testumi \ --identity-type UserAssigned --pid /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/testumi \ --subnet /subscriptions/78975f9f-2222-1111-1111-29c42ac70000/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/vnet-test/subnets/ManagedInstance

创建启用了区域冗余的托管实例

az sql mi create -g mygroup -n myinstance -l mylocation -i -u myusername -p mypassword --subnet /subscriptions/{SubID}/resourceGroups/{ResourceGroup}/providers/Microsoft.Network/virtualNetworks/{VNETName}/subnets/{SubnetName} -z

创建具有显式禁用区域冗余的托管实例

az sql mi create -g mygroup -n myinstance -l mylocation -i -u myusername -p mypassword --subnet /subscriptions/{SubID}/resourceGroups/{ResourceGroup}/providers/Microsoft.Network/virtualNetworks/{VNETName}/subnets/{SubnetName} -z false

使用实例池名称创建托管实例

az sql mi create -g mygroup -n myinstance -l mylocation -i -u myusername -p mypassword --subnet /subscriptions/{SubID}/resourceGroups/{ResourceGroup}/providers/Microsoft.Network/virtualNetworks/{VNETName}/subnets/{SubnetName} --instance-pool-name myinstancepool

使用数据库格式和定价模型创建托管实例

az sql mi create -g mygroup -n myinstance -l mylocation -i -u myusername -p mypassword --subnet /subscriptions/{SubID}/resourceGroups/{ResourceGroup}/providers/Microsoft.Network/virtualNetworks/{VNETName}/subnets/{SubnetName} --database-format AlwaysUpToDate --pricing-model Regular

使用 dns 区域合作伙伴创建托管实例

az sql mi create -g mygroup -n myinstance -l mylocation -i -u myusername -p mypassword --subnet /subscriptions/{SubID}/resourceGroups/{ResourceGroup}/providers/Microsoft.Network/virtualNetworks/{VNETName}/subnets/{SubnetName} --dns-zone-partner dns

必需参数

--name -n

托管实例名称。

--resource-group -g

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

--subnet

允许访问 Azure Sql 托管实例的子网的名称或 ID。如果提供了子网名称，则必须提供 --vnet-name。

可选参数

--admin-password -p

管理员登录密码（创建托管实例时需要）。

--admin-user -u

托管实例的管理员用户名。在创建托管实例时指定 Canonly（创建时需要）。

--assign-identity -i

为此托管实例生成并分配 Azure Active Directory 标识，以用于 Azure KeyVault 等密钥管理服务。

默认值: False

--backup-storage-redundancy --bsr

用于存储备份的备份存储冗余。允许的值包括：Local、Zone、Geo、GeoZone。

--capacity -c

托管实例的容量（以整数数表示的 vcore 数）。

--collation

托管实例的排序规则。

--database-format

托管实例特定于 SQL 的数据库格式。允许的值包括：AlwaysUpToDate、SQLServer2022。

接受的值: AlwaysUpToDate, SQLServer2022

--dns-zone-partner

要从中创建托管实例的 DnsZone 属性的合作伙伴托管实例的资源 ID。

--edition --tier -e

SKU 的版本组件。允许的值包括：GeneralPurpose、BusinessCritical。

--enable-ad-only-auth

为此服务器启用仅限 Azure Active Directory 身份验证。

默认值: False

--external-admin-name

Azure AD 管理员用户、组或应用程序的显示名称。

--external-admin-principal-type

用户、组或应用程序。

--external-admin-sid

Azure AD 管理员的唯一 ID。用户或组的对象 ID、应用程序的客户端 ID。

--family -f

SKU 的计算生成组件。允许的值包括：Gen4、Gen5。

--identity-type -t

要使用的标识类型。可能的值为 SystemAsssigned、UserAssigned、SystemAssignedUserAssigned 和 None。

接受的值: None, SystemAssigned, SystemAssigned,UserAssigned, UserAssigned

--instance-pool-name

将放置托管实例的实例池的名称。

--key-id -k

用于加密的密钥保管库 URI。

--license-type

要应用于此托管实例的许可证类型。

接受的值: BasePrice, LicenseIncluded

--location -l

Location。 az account list-locations 中的值。可以使用 az configure --defaults location=<location> 配置默认位置。

--maint-config-id -m

将维护配置分配给此托管实例。

--minimal-tls-version

预览

托管实例强制要求为入站连接使用的最低 TLS 版本。

接受的值: 1.0, 1.1, 1.2, None

--no-wait

不等待长时间运行的操作完成。

默认值: False

--pid --primary-user-assigned-identity-id

主要用户托管标识的 ID。

--pricing-model

托管实例定价模型。允许的值包括：Regular、Freemium。

接受的值: Freemium, Regular

--proxy-override

用于连接到实例的连接类型。

接受的值: Default, Proxy, Redirect

--public-data-endpoint-enabled

是否为实例启用公共数据终结点。

接受的值: false, true

--service-principal-type

要用于此托管实例的服务主体类型。可能的值为 SystemAssigned 和 None。

接受的值: None, SystemAssigned

--storage

托管实例的存储大小。必须以 32 GB 的增量指定存储大小。

--tags

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

--timezone-id

要设置的实例的时区 ID。时区 ID 列表通过 sys.time_zone_info （Transact-SQL）视图公开。

--user-assigned-identity-id -a

为此服务器生成并分配用户托管标识（UMI）。

--vnet-name

虚拟网络名称。

--yes -y

不提示确认。

默认值: False

--zone-redundant -z

指定是否启用区域冗余。如果未指定任何值，则默认值为 true。

接受的值: false, 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 mi delete

编辑

删除托管实例。

az sql mi delete [--ids]
                 [--name]
                 [--no-wait]
                 [--resource-group]
                 [--subscription]
                 [--yes]

示例

删除托管实例

az sql mi delete -g mygroup -n myinstance --yes

可选参数

--ids

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

--name -n

托管实例名称。

--no-wait

不等待长时间运行的操作完成。

默认值: False

--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 mi failover

编辑

故障转移托管实例。

az sql mi failover [--ids]
                   [--name]
                   [--no-wait]
                   [--replica-type]
                   [--resource-group]
                   [--subscription]

示例

故障转移托管实例主副本

az sql mi failover -g mygroup -n myinstance

故障转移托管实例可读的可读秒副本

az sql mi failover -g mygroup -n myinstance --replica-type ReadableSecondary

可选参数

--ids

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

--name -n

托管实例名称。

--no-wait

不等待长时间运行的操作完成。

默认值: False

--replica-type

要故障转移的副本的类型。已知值为：“Primary”和“ReadableSecondary”。默认值为无。

--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 mi list

编辑

列出可用的托管实例。

az sql mi list [--expand-ad-admin]
               [--resource-group]

示例

列出当前订阅中的所有托管实例。

az sql mi list

列出资源组中的所有托管实例。

az sql mi list -g mygroup

可选参数

--expand-ad-admin

展开服务器的 Active Directory 管理员。

默认值: False

--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 mi refresh-external-governance-status

编辑

刷新外部治理启用状态。

az sql mi refresh-external-governance-status [--ids]
                                             [--managed-instance-name]
                                             [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                             [--resource-group]
                                             [--subscription]

示例

更新特定 MI 上的外部治理状态

az sql mi refresh-external-governance-status --managed-instance-name managedInstance -g resourceGroup1 --subscription xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

可选参数

--ids

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

--managed-instance-name --mi

托管实例的名称。

--no-wait

不等待长时间运行的操作完成。

接受的值: 0, 1, f, false, n, no, t, true, y, yes

--resource-group -g

资源组的名称。

--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 mi show

编辑

获取托管实例的详细信息。

az sql mi show [--expand-ad-admin]
               [--ids]
               [--name]
               [--resource-group]
               [--subscription]

示例

获取托管实例的详细信息

az sql mi show -g mygroup -n myinstance

可选参数

--expand-ad-admin

展开服务器的 Active Directory 管理员。

默认值: False

--ids

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

--name -n

托管实例名称。

--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 mi start

编辑

启动托管实例。

az sql mi start [--ids]
                [--managed-instance]
                [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                [--resource-group]
                [--subscription]

示例

启动托管实例。

az sql mi start --ids resourceId
az sql mi start --mi miName -g resourceGroup --subscription subscription

可选参数

--ids

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

--managed-instance --mi

托管实例的名称。

--no-wait

不等待长时间运行的操作完成。

接受的值: 0, 1, f, false, n, no, t, true, y, yes

--resource-group -g

资源组的名称。

--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 mi stop

编辑

停止托管实例。

az sql mi stop [--ids]
               [--managed-instance]
               [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
               [--resource-group]
               [--subscription]

示例

停止托管实例。

az sql mi stop --ids resourceId
az sql mi stop --mi miName -g resourceGroup --subscription subscription

可选参数

--ids

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

--managed-instance --mi

托管实例的名称。

--no-wait

不等待长时间运行的操作完成。

接受的值: 0, 1, f, false, n, no, t, true, y, yes

--resource-group -g

资源组的名称。

--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 mi update

编辑

更新托管实例。

az sql mi update [--add]
                 [--admin-password]
                 [--assign-identity]
                 [--backup-storage-redundancy]
                 [--capacity]
                 [--database-format {AlwaysUpToDate, SQLServer2022}]
                 [--edition]
                 [--family]
                 [--force-string]
                 [--identity-type {None, SystemAssigned, SystemAssigned,UserAssigned, UserAssigned}]
                 [--ids]
                 [--instance-pool-name]
                 [--key-id]
                 [--license-type {BasePrice, LicenseIncluded}]
                 [--maint-config-id]
                 [--minimal-tls-version {1.0, 1.1, 1.2, None}]
                 [--name]
                 [--no-wait]
                 [--pid]
                 [--pricing-model {Freemium, Regular}]
                 [--proxy-override {Default, Proxy, Redirect}]
                 [--public-data-endpoint-enabled {false, true}]
                 [--remove]
                 [--resource-group]
                 [--service-principal-type {None, SystemAssigned}]
                 [--set]
                 [--storage]
                 [--subnet]
                 [--subscription]
                 [--tags]
                 [--user-assigned-identity-id]
                 [--vnet-name]
                 [--yes]
                 [--zone-redundant {false, true}]

示例

使用指定的参数和标识更新 mi

az sql mi update -g mygroup -n myinstance -i -p mypassword --license-type mylicensetype --capacity vcorecapacity --storage storagesize

更新 mi 版本和硬件系列

az sql mi update -g mygroup -n myinstance --tier GeneralPurpose --family Gen5

添加或更新标记。

az sql mi update -g mygroup -n myinstance --set tags.tagName=tagValue

删除标记。

az sql mi update -g mygroup -n myinstance --remove tags.tagName

更新托管实例。（自动生成）

az sql mi update --name myinstance --proxy-override Default --resource-group mygroup --subscription MySubscription

更新托管实例。（自动生成）

az sql mi update --name myinstance --public-data-endpoint-enabled true --resource-group mygroup --subscription MySubscription

使用维护配置更新托管实例

az sql mi update -g mygroup -n myinstance -m SQL_{Region}_{MaintenanceConfigName}

从托管实例中删除维护配置

az sql mi update -g mygroup -n myinstance -m SQL_Default

使用服务主体更新托管实例

az sql mi update -g mygroup -n myinstance --service-principal-type SystemAssigned

使用用户托管 Identies 和标识类型更新托管实例是 SystemAssigned，UserAssigned。

az sql mi update -g myResourceGroup -n myServer -i \ --user-assigned-identity-id /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/testumi \ --identity-type SystemAssigned,UserAssigned --pid /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/testumi

使用用户托管 Identies 更新托管实例，标识类型为 UserAssigned

az sql mi update -g myResourceGroup -n myServer -i \ --user-assigned-identity-id /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/testumi \ --identity-type UserAssigned --pid /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/testumi

将托管实例移到另一个子网

az sql mi update -g myResourceGroup -n myServer -i \ --subnet /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/myvnet/subnets/mysubnet \

更新 mi 备份存储冗余

az sql mi update -g mygroup -n myinstance --bsr Local

在托管实例上启用区域冗余

az sql mi update -g mygroup -n myinstance -z

将托管实例移动到实例池

az sql mi update -g mygroup -n myinstance --instance-pool-name myinstancepool

将托管实例移出实例池

az sql mi update -g mygroup -n myinstance --remove instancePoolId --capacity vcorecapacity

更新 mi 数据库格式和定价模型

az sql mi update -g mygroup -n myinstance --database-format AlwaysUpToDate --pricing-model Regular

可选参数

--add

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

默认值: []

--admin-password -p

管理员登录密码（创建托管实例时需要）。

--assign-identity -i

为此托管实例生成并分配 Azure Active Directory 标识，以用于 Azure KeyVault 等密钥管理服务。如果已分配标识，则不执行任何操作。

默认值: False

--backup-storage-redundancy --bsr

用于存储备份的备份存储冗余。允许的值包括：Local、Zone、Geo、GeoZone。

--capacity -c

托管实例的容量（以整数数表示的 vcore 数）。

--database-format

托管实例特定于 SQL 的数据库格式。允许的值包括：AlwaysUpToDate、SQLServer2022。

接受的值: AlwaysUpToDate, SQLServer2022

--edition --tier -e

SKU 的版本组件。允许的值包括：GeneralPurpose、BusinessCritical。

--family -f

SKU 的计算生成组件。允许的值包括：Gen4、Gen5。

--force-string

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

默认值: False

--identity-type -t

要使用的标识类型。可能的值为 SystemAsssigned、UserAssigned、SystemAssignedUserAssigned 和 None。

接受的值: None, SystemAssigned, SystemAssigned,UserAssigned, UserAssigned

--ids

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

--instance-pool-name

将放置托管实例的实例池的名称。

--key-id -k

用于加密的密钥保管库 URI。

--license-type

要应用于此托管实例的许可证类型。

接受的值: BasePrice, LicenseIncluded

--maint-config-id -m

更改此托管实例的维护配置。

--minimal-tls-version

预览

托管实例强制要求为入站连接使用的最低 TLS 版本。

接受的值: 1.0, 1.1, 1.2, None

--name -n

托管实例名称。

--no-wait

不等待长时间运行的操作完成。

默认值: False

--pid --primary-user-assigned-identity-id

主要用户托管标识的 ID。

--pricing-model

托管实例定价模型。允许的值包括：Regular、Freemium。

接受的值: Freemium, Regular

--proxy-override

用于连接到实例的连接类型。

接受的值: Default, Proxy, Redirect

--public-data-endpoint-enabled

是否为实例启用公共数据终结点。

接受的值: false, true

--remove

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

默认值: []

--resource-group -g

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

--service-principal-type

要用于此托管实例的服务主体类型。可能的值为 SystemAssigned 和 None。

接受的值: None, SystemAssigned

--set

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

默认值: []

--storage

托管实例的存储大小。必须以 32 GB 的增量指定存储大小。

--subnet

允许访问 Azure Sql 托管实例的子网的名称或 ID。如果提供了子网名称，则必须提供 --vnet-name。

--subscription

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

--tags

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

--user-assigned-identity-id -a

为此服务器生成并分配用户托管标识（UMI）。

--vnet-name

虚拟网络名称。

--yes -y

不提示确认。

默认值: False

--zone-redundant -z

指定是否启用区域冗余。如果未指定任何值，则默认值为 true。

接受的值: false, 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 mi

命令

az sql mi create

示例

必需参数

可选参数

az sql mi delete

示例

可选参数

az sql mi failover

示例

可选参数

az sql mi list

示例

可选参数

az sql mi refresh-external-governance-status

示例

可选参数

az sql mi show

示例

可选参数

az sql mi start

示例

可选参数

az sql mi stop

示例

可选参数

az sql mi update

示例

可选参数

其他资源