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

az sql mi

管理 SQL 托管实例。

命令

名称 说明 类型 状态
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 管理员istrator。

核心 GA
az sql mi ad-admin list

返回托管实例 Active Directory 管理员istrators 的列表。

核心 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}]
                 [--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 Regular --pricing-model AlwaysUpToDate

必需参数

--name -n

托管实例名称。

--resource-group -g

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

--subnet

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

可选参数

--admin-password -p

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

--admin-user -u

管理员托管实例的istrator 用户名。 在创建托管实例时指定 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
--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(以空格分隔)。 它应该是包含“资源 ID”参数的所有信息的完整资源 ID。 应提供 --id 或其他“资源 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]

示例

故障转移托管实例主副本 (replica)

az sql mi failover -g mygroup -n myinstance

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

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

可选参数

--ids

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

--name -n

托管实例名称。

--no-wait

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

默认值: False
--replica-type

要故障转移的副本 (replica)的类型。 已知值为:“Primary”和“ReadableSecondary”。 默认值为 None。

--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 管理员istrator。

默认值: 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(以空格分隔)。 它应该是包含“资源 ID”参数的所有信息的完整资源 ID。 应提供 --id 或其他“资源 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 管理员istrator。

默认值: False
--ids

一个或多个资源 ID(以空格分隔)。 它应该是包含“资源 ID”参数的所有信息的完整资源 ID。 应提供 --id 或其他“资源 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(以空格分隔)。 它应该是包含“资源 ID”参数的所有信息的完整资源 ID。 应提供 --id 或其他“资源 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(以空格分隔)。 它应该是包含“资源 ID”参数的所有信息的完整资源 ID。 应提供 --id 或其他“资源 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 Regular --pricing-model AlwaysUpToDate

可选参数

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