az sql mi

參考

管理 SQL 受控實例。

命令

名稱	Description	類型	狀態
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 僅限 Authentication 屬性。	核心	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	取得在具有指定標識碼的端點上使用的憑證。	核心	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	建立新的實例連結。	核心	已取代
az sql mi link delete	拿掉實例連結。	核心	GA
az sql mi link list	傳回 Azure SQL 受控執行個體連結功能的相關信息。	核心	已取代
az sql mi link show	傳回 Azure SQL 受控執行個體連結功能的相關信息。	核心	已取代
az sql mi link update	更新實例連結的屬性。	核心	已取代
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]
                 [--am {AzureAD, Paired, Windows}]
                 [--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]
                 [--gpv2 {false, true}]
                 [--identity-type {None, SystemAssigned, SystemAssigned,UserAssigned, UserAssigned}]
                 [--instance-pool-name]
                 [--iops]
                 [--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 Admin 的情況下建立受控實例，且已啟用 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 Admin 的情況下建立受控實例，並啟用 AD 管理員、僅啟用 AD、User ManagedIdenties 和 Identity Type 為 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 Admin 的情況下建立受控實例，並啟用 AD 管理員、僅啟用 AD、User ManagedIdenties 和 Identity Type 為 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

建立使用 Windows 驗證元數據模式的受控實例

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} --am Windows

建立具有指定 IOPS 限制的 GPv2 受控實例

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} -e GeneralPurpose --gpv2 true -f Gen8IH -c 4 --storage 256GB --iops 3000

必要參數

--name -n

受控實例名稱。

--resource-group -g

資源群組的名稱。您可以使用 az configure --defaults group=<name> 來設定預設群組。

--subnet

允許存取 Azure Sql 受控執行個體之子網的名稱或標識碼。如果提供子網名稱，則必須提供 --vnet-name。

選擇性參數

--admin-password -p

系統管理員登入密碼（建立受控實例時需要）。

--admin-user -u

受控實例的系統管理員用戶名稱。建立受控實例時，必須指定 Canonly （且建立時為必要專案）。

--am --authentication-metadata

用於驗證同步內部部署使用者的慣用元數據。預設值為 AzureAD。

接受的值: AzureAD, Paired, Windows

--assign-identity -i

產生並指派此受控實例的 Azure Active Directory 身分識別，以搭配 Azure KeyVault 等密鑰管理服務使用。

預設值: False

--backup-storage-redundancy --bsr

用來儲存備份的備份記憶體備援。允許的值包括：Local、Zone、Geo、GeoZone。

--capacity -c

受控實例的容量，以虛擬核心的整數數目表示。

--collation

受控實例的定序。

--database-format

受控執行個體 SQL 特定的資料庫格式。允許的值包括：AlwaysUpToDate、SQLServer2022。

接受的值: AlwaysUpToDate, SQLServer2022

--dns-zone-partner

要從中繼承 DnsZone 屬性之夥伴受控執行個體的資源識別碼，以進行受控執行個體建立。

--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 系統管理員的唯一標識碼。使用者或群組的物件標識碼、應用程式的用戶端識別碼。

--family -f

SKU 的計算產生元件。允許的值包括：Gen4、Gen5。

--gpv2

這是否為一般用途版本的 GPv2 變體。

接受的值: false, true

--identity-type -t

要使用的身分識別類型。可能的值為 SystemAsssigned、UserAssigned、SystemAssignedUserAssigned 和 None。

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

--instance-pool-name

將放置受控實例的實例集區名稱。

--iops

受控實例的記憶體 iops。記憶體 iops 可以遞增 1 來指定。

--key-id -k

用於加密的金鑰保存庫 URI。

--license-type

要套用此受控實例的授權類型。

接受的值: BasePrice, LicenseIncluded

--location -l

位置。值的來源：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

主要使用者受控識別的標識碼。

--pricing-model

受控執行個體定價模式。允許的值包括：一般、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

要設定之實例的時區標識碼。時區標識符清單會透過 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

訂用帳戶的名稱或識別碼。您可以使用 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

一或多個資源識別碼 (以空格分隔)。它應該是完整資源識別碼，其中包含「資源標識碼」引數的所有資訊。您應該提供 --ids 或其他「資源識別碼」引數。

--name -n

受控實例名稱。

--no-wait

請勿等候長時間執行的作業完成。

預設值: False

--resource-group -g

資源群組的名稱。您可以使用 az configure --defaults group=<name> 來設定預設群組。

--subscription

訂用帳戶的名稱或識別碼。您可以使用 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

訂用帳戶的名稱或識別碼。您可以使用 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

--name -n

受控實例名稱。

--no-wait

請勿等候長時間執行的作業完成。

預設值: False

--replica-type

要故障轉移的複本類型。已知值為：“Primary” 和 “ReadableSecondary”。預設值為 None。

--resource-group -g

資源群組的名稱。您可以使用 az configure --defaults group=<name> 來設定預設群組。

--subscription

訂用帳戶的名稱或識別碼。您可以使用 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

訂用帳戶的名稱或識別碼。您可以使用 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

訂用帳戶的名稱或識別碼。您可以使用 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

--managed-instance-name --mi

受控實例的名稱。

--no-wait

請勿等候長時間執行的作業完成。

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

--resource-group -g

資源群組的名稱。

--subscription

訂用帳戶的名稱或識別碼。您可以使用 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

訂用帳戶的名稱或識別碼。您可以使用 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

--name -n

受控實例名稱。

--resource-group -g

資源群組的名稱。您可以使用 az configure --defaults group=<name> 來設定預設群組。

--subscription

訂用帳戶的名稱或識別碼。您可以使用 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

訂用帳戶的名稱或識別碼。您可以使用 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

--managed-instance --mi

受控實例的名稱。

--no-wait

請勿等候長時間執行的作業完成。

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

--resource-group -g

資源群組的名稱。

--subscription

訂用帳戶的名稱或識別碼。您可以使用 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

訂用帳戶的名稱或識別碼。您可以使用 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

--managed-instance --mi

受控實例的名稱。

--no-wait

請勿等候長時間執行的作業完成。

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

--resource-group -g

資源群組的名稱。

--subscription

訂用帳戶的名稱或識別碼。您可以使用 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

訂用帳戶的名稱或識別碼。您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。

--verbose

增加記錄詳細資訊。使用 --debug 來取得完整偵錯記錄。

az sql mi update

編輯

更新受控實例。

az sql mi update [--add]
                 [--admin-password]
                 [--am {AzureAD, Paired, Windows}]
                 [--assign-identity]
                 [--backup-storage-redundancy]
                 [--capacity]
                 [--database-format {AlwaysUpToDate, SQLServer2022}]
                 [--edition]
                 [--family]
                 [--force-string]
                 [--gpv2 {false, true}]
                 [--identity-type {None, SystemAssigned, SystemAssigned,UserAssigned, UserAssigned}]
                 [--ids]
                 [--instance-pool-name]
                 [--iops]
                 [--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

使用使用者受控標識碼和身分識別類型更新受控實例為 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

使用使用者受控標識碼和身分識別類型更新受控實例為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

更新受控實例以使用 Windows 驗證元數據模式

az sql mi update -g mygroup -n myinstance --am Windows

將受控實例更新為具有指定 IOPS 限制的 GPv2

az sql mi update -g mygroup -n myinstance -e GeneralPurpose --gpv2 true --iops 3000

選擇性參數

--add

藉由指定路徑和索引鍵值組，將物件加入物件清單。範例：--add property.listProperty <key=value, string or JSON string>。

預設值: []

--admin-password -p

系統管理員登入密碼（建立受控實例時需要）。

--am --authentication-metadata

用於驗證同步內部部署使用者的慣用元數據。預設值為 AzureAD。

接受的值: AzureAD, Paired, Windows

--assign-identity -i

產生並指派此受控實例的 Azure Active Directory 身分識別，以搭配 Azure KeyVault 等密鑰管理服務使用。如果已指派身分識別 - 不執行任何動作。

預設值: False

--backup-storage-redundancy --bsr

用來儲存備份的備份記憶體備援。允許的值包括：Local、Zone、Geo、GeoZone。

--capacity -c

受控實例的容量，以虛擬核心的整數數目表示。

--database-format

受控執行個體 SQL 特定的資料庫格式。允許的值包括：AlwaysUpToDate、SQLServer2022。

接受的值: AlwaysUpToDate, SQLServer2022

--edition --tier -e

SKU 版本元件。允許的值包括：GeneralPurpose、BusinessCritical。

--family -f

SKU 的計算產生元件。允許的值包括：Gen4、Gen5。

--force-string

使用 'set' 或 'add' 時，請保留字串常值，而不是嘗試轉換成 JSON。

預設值: False

--gpv2

這是否為一般用途版本的 GPv2 變體。

接受的值: false, true

--identity-type -t

要使用的身分識別類型。可能的值為 SystemAsssigned、UserAssigned、SystemAssignedUserAssigned 和 None。

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

--ids

--instance-pool-name

將放置受控實例的實例集區名稱。

--iops

受控實例的記憶體 iops。記憶體 iops 可以遞增 1 來指定。

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

主要使用者受控識別的標識碼。

--pricing-model

受控執行個體定價模式。允許的值包括：一般、Freemium。

接受的值: Freemium, Regular

--proxy-override

用於連接到實例的連接類型。

接受的值: Default, Proxy, Redirect

--public-data-endpoint-enabled

實例是否啟用公用數據端點。

接受的值: false, true

--remove

從清單中移除屬性或專案。範例： --remove property.list <indexToRemove> 或 --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 受控執行個體的子網名稱或標識碼。如果提供子網名稱，則必須提供 --vnet-name。

--subscription

訂用帳戶的名稱或識別碼。您可以使用 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

訂用帳戶的名稱或識別碼。您可以使用 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

範例

選擇性參數

其他資源