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 管理員 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 僅限 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

建立新的實例連結。

 核心 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、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 管理員 的受控實例，並啟用 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 受控執行個體 之子網的名稱或標識碼。 如果提供子網名稱，則必須提供 --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

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

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

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

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

一或多個資源識別碼 (以空格分隔)。 它應該是包含 「資源標識碼」自變數所有資訊的完整資源識別碼。 您應該提供 --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 管理員 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

訂用帳戶的名稱或標識碼。 您可以使用 來設定預設訂用 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

一或多個資源識別碼 (以空格分隔)。 它應該是包含 「資源標識碼」自變數所有資訊的完整資源識別碼。 您應該提供 --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 管理員 istrator。

預設值: False
--ids

一或多個資源識別碼 (以空格分隔)。 它應該是包含 「資源標識碼」自變數所有資訊的完整資源識別碼。 您應該提供 --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

一或多個資源識別碼 (以空格分隔)。 它應該是包含 「資源標識碼」自變數所有資訊的完整資源識別碼。 您應該提供 --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

一或多個資源識別碼 (以空格分隔)。 它應該是包含 「資源標識碼」自變數所有資訊的完整資源識別碼。 您應該提供 --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]
                 [--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

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

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

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

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

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

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

--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 來取得完整偵錯記錄。