Share via


az sql mi dtc

與受控實例 DTC 管理相關的命令。

您可以使用這些命令來擷取和更新受控實例 DTC 物件。

命令

名稱 Description 類型 狀態
az sql mi dtc show

取得受控實例 DTC 設定。

核心 GA
az sql mi dtc update

更新受控實例 DTC 設定。

核心 GA
az sql mi dtc wait

將 CLI 置於等候狀態,直到符合條件為止。

核心 GA

az sql mi dtc show

取得受控實例 DTC 設定。

此命令會取得受控實例 DTC 設定。

az sql mi dtc show [--ids]
                   [--managed-instance-name]
                   [--resource-group]
                   [--subscription]

範例

取得受控實例 DTC

az sql mi show --g resourceGroup1 --managed-instance-name managedInstance1

取得具有指定資源識別碼的受控實例 DTC

az sql mi show --ids /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/ResourceGroup1/providers/Microsoft.Sql/managedInstances/ManagedInstance1/dtc/current

選擇性參數

--ids

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

--managed-instance-name --mi

受控實例的名稱。

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

更新受控實例 DTC 設定。

此命令會更新受控實例 DTC 設定。 所有參數都是選擇性的。

az sql mi dtc update [--add]
                     [--allow-inbound-enabled {0, 1, f, false, n, no, t, true, y, yes}]
                     [--allow-outbound-enabled {0, 1, f, false, n, no, t, true, y, yes}]
                     [--authentication]
                     [--dtc-enabled {0, 1, f, false, n, no, t, true, y, yes}]
                     [--external-dns-suffix-search-list]
                     [--force-string {0, 1, f, false, n, no, t, true, y, yes}]
                     [--ids]
                     [--managed-instance-name]
                     [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                     [--remove]
                     [--resource-group]
                     [--set]
                     [--sna-lu-transactions {0, 1, f, false, n, no, t, true, y, yes}]
                     [--subscription]
                     [--xa-default-timeout]
                     [--xa-max-timeout]
                     [--xa-transactions {0, 1, f, false, n, no, t, true, y, yes}]

範例

在受控實例上啟用 DTC

az sql mi dtc update -g resourceGroup1 --mi managedInstance1 --dtc-enabled true
az sql mi dtc update --ids /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/ResourceGroup1/providers/Microsoft.Sql/managedInstances/ManagedInstance1/dtc/current --dtc-enabled true

允許受控實例 DTC 的 XA 交易

az sql mi dtc update -g resourceGroup1 --mi managedInstance1 --xa-transactions-enabled true

選擇性參數

--add

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

--allow-inbound-enabled

允許對受控實例 DTC 的輸入流量。

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

允許受控實例 DTC 的輸出流量。

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

受控實例 DTC 的驗證類型。

--dtc-enabled

受控實例 DTC 的作用中狀態。

接受的值: 0, 1, f, false, n, no, t, true, y, yes
--external-dns-suffix-search-list --external-dns-suffixes

受控實例 DTC 的外部 DNS 尾碼搜尋清單。 支援速記語法、json-file 和 yaml-file。 請嘗試 「??」 以顯示更多。

--force-string

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

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

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

--managed-instance-name --mi

受控實例的名稱。

--no-wait

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

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

從清單中移除屬性或專案。 範例:--remove property.list OR --remove 屬性ToRemove。

--resource-group -g

資源群組的名稱。

--set

指定要設定的屬性路徑和值,以更新物件。 範例:--set property1.property2=。

--sna-lu-transactions --sna-lu6point2-transactions-enabled

允許 SNA LU 6.2 交易到受控實例 DTC。

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

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

--xa-default-timeout --xa-transactions-default-timeout

XA 交易的預設逾時(以秒為單位)。

--xa-max-timeout --xa-transactions-maximum-timeout

XA 交易的逾時上限(以秒為單位)。

--xa-transactions --xa-transactions-enabled

允許 XA 交易到受控實例 DTC。

接受的值: 0, 1, f, false, n, no, t, true, y, yes
全域參數
--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 dtc wait

將 CLI 置於等候狀態,直到符合條件為止。

az sql mi dtc wait [--created]
                   [--custom]
                   [--deleted]
                   [--exists]
                   [--ids]
                   [--interval]
                   [--managed-instance-name]
                   [--resource-group]
                   [--subscription]
                   [--timeout]
                   [--updated]

選擇性參數

--created

請等候在 'Succeeded' 使用 'provisioningState' 建立。

預設值: False
--custom

等到條件符合自訂 JMESPath 查詢為止。 例如 provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running']。

--deleted

等到刪除為止。

預設值: False
--exists

等候資源存在。

預設值: False
--ids

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

--interval

輪詢間隔以秒為單位。

預設值: 30
--managed-instance-name --mi

受控實例的名稱。

--resource-group -g

資源群組的名稱。

--subscription

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

--timeout

以秒為單位的等候上限。

預設值: 3600
--updated

等到 provisioningState 更新為 'Succeeded'。

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