az dns-resolver forwarding-ruleset
注意
此參考是 Azure CLI 的 dns 解析程式擴充功能的一部分(2.61.0 版或更高版本)。 擴充功能會在您第一次執行 az dns-resolver forwarding-ruleset 命令時自動安裝。 深入了解擴充功能。
使用 dns 解析程式管理轉送規則集。
命令
名稱 | Description | 類型 | 狀態 |
---|---|---|---|
az dns-resolver forwarding-ruleset create |
建立 DNS 轉送規則集。 |
副檔名 | GA |
az dns-resolver forwarding-ruleset delete |
刪除 DNS 轉送規則集。 警告:無法復原此作業。 將會刪除規則集內的所有轉送規則。 |
副檔名 | GA |
az dns-resolver forwarding-ruleset list |
列出連結至虛擬網路的 DNS 轉送規則集資源識別碼。 並列出資源群組內的 DNS 轉送規則集。 和列出訂用帳戶所有資源群組中的 DNS 轉送規則集。 |
副檔名 | GA |
az dns-resolver forwarding-ruleset list-by-virtual-network |
列出連結至虛擬網路的 DNS 轉送規則集資源識別碼。 |
副檔名 | GA |
az dns-resolver forwarding-ruleset show |
取得 DNS 轉送規則集屬性。 |
副檔名 | GA |
az dns-resolver forwarding-ruleset update |
更新 DNS 轉送規則集。 |
副檔名 | GA |
az dns-resolver forwarding-ruleset wait |
將 CLI 置於等候狀態,直到符合條件為止。 |
副檔名 | GA |
az dns-resolver forwarding-ruleset create
建立 DNS 轉送規則集。
az dns-resolver forwarding-ruleset create --dns-forwarding-ruleset-name
--outbound-endpoints
--resource-group
[--if-match]
[--if-none-match]
[--location]
[--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
[--tags]
範例
Upsert DNS 轉送規則集
az dns-resolver forwarding-ruleset create --name "samplednsForwardingRuleset" --location "westus2" --outbound-endpoints [{id:"/subscriptions/abdd4249-9f34-4cc6-8e42-c2e32110603e/resou rceGroups/sampleResourceGroup/providers/Microsoft.Network/dnsResolvers/sampleDnsResolver/out boundEndpoints/sampleOutboundEndpoint0"},{id:"/subscriptions/abdd4249-9f3 4-4cc6-8e42-c2e32110603e/resourceGroups/sampleResourceGroup/providers/Microsoft.Network/dnsR esolvers/sampleDnsResolver/outboundEndpoints/sampleOutboundEndpoint1"}] --tags key1="value1" --resource-group "sampleResourceGroup"
必要參數
DNS 轉送規則集的名稱。
DNS 解析程式輸出端點的參考,這些端點用來將符合規則集中轉送規則的 DNS 查詢路由傳送至目標 DNS 伺服器。 支援速記語法、json-file 和 yaml-file。 請嘗試 “??” 以顯示更多。
資源群組的名稱。 您可以使用 az configure --defaults group=<name>
來設定預設群組。
選擇性參數
資源的 ETag。 請省略此值以一律覆寫目前的資源。 指定最後看到的 ETag 值,以防止意外覆寫任何並行變更。
設定為 『*』 以允許建立新的資源,但為了避免更新現有的資源。 將會忽略其他值。
位置。 值的來源:az account list-locations
。 您可以使用 az configure --defaults location=<location>
設定預設位置。 未指定時,將會使用資源群組的位置。
請勿等候長時間執行的作業完成。
以空格分隔的標記:key[=value] [key[=value] ...]。支援速記語法、json-file 和 yaml-file。 請嘗試 “??” 以顯示更多。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID
設定預設訂用帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。
az dns-resolver forwarding-ruleset delete
刪除 DNS 轉送規則集。 警告:無法復原此作業。 將會刪除規則集內的所有轉送規則。
az dns-resolver forwarding-ruleset delete [--dns-forwarding-ruleset-name]
[--ids]
[--if-match]
[--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
[--resource-group]
[--subscription]
[--yes]
範例
刪除 DNS 轉送規則集
az dns-resolver forwarding-ruleset delete --name "samplednsForwardingRulesetName" --resource-group "sampleResourceGroup"
選擇性參數
DNS 轉送規則集的名稱。
一或多個資源識別碼 (以空格分隔)。 它應該是完整資源識別碼,其中包含「資源標識碼」引數的所有資訊。 您應該提供 --ids 或其他「資源識別碼」引數。
資源的 ETag。 請省略此值以一律覆寫目前的資源。 指定最後看到的 ETag 值,以防止意外覆寫任何並行變更。
請勿等候長時間執行的作業完成。
資源群組的名稱。 您可以使用 az configure --defaults group=<name>
來設定預設群組。
訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID
設定預設訂用帳戶。
不提示確認。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID
設定預設訂用帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。
az dns-resolver forwarding-ruleset list
列出連結至虛擬網路的 DNS 轉送規則集資源識別碼。 並列出資源群組內的 DNS 轉送規則集。 和列出訂用帳戶所有資源群組中的 DNS 轉送規則集。
az dns-resolver forwarding-ruleset list [--resource-group]
[--top]
[--virtual-network-name]
範例
列出虛擬網路的 DNS 轉送規則集
az dns-resolver forwarding-ruleset list --resource-group "sampleResourceGroup" --virtual-network-name "sampleVirtualNetwork"
依資源群組列出 DNS 轉送規則集
az dns-resolver forwarding-ruleset list --resource-group "sampleResourceGroup"
依訂用帳戶列出 DNS 轉送規則集
az dns-resolver forwarding-ruleset list
選擇性參數
資源群組的名稱。 您可以使用 az configure --defaults group=<name>
來設定預設群組。
要傳回的結果數目上限。 如果未指定,則最多會傳回 100 個結果。
虛擬網路的名稱。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID
設定預設訂用帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。
az dns-resolver forwarding-ruleset list-by-virtual-network
列出連結至虛擬網路的 DNS 轉送規則集資源識別碼。
az dns-resolver forwarding-ruleset list-by-virtual-network --resource-group
--virtual-network-name
[--max-items]
[--next-token]
[--top]
範例
列出虛擬網路的 DNS 轉送規則集
az dns-resolver forwarding-ruleset list --resource-group "sampleResourceGroup" --virtual- network-name "sampleVirtualNetwork"
必要參數
資源群組的名稱。 您可以使用 az configure --defaults group=<name>
來設定預設群組。
虛擬網路的名稱。
選擇性參數
命令輸出中要傳回的項目總數。 如果可用的專案總數超過指定的值,則會在命令的輸出中提供令牌。 若要繼續分頁,請在後續命令的自變數中 --next-token
提供令牌值。
標記,指定要開始分頁的位置。 這是先前截斷回應中的令牌值。
要傳回的結果數目上限。 如果未指定,則最多會傳回 100 個結果。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID
設定預設訂用帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。
az dns-resolver forwarding-ruleset show
取得 DNS 轉送規則集屬性。
az dns-resolver forwarding-ruleset show [--dns-forwarding-ruleset-name]
[--ids]
[--resource-group]
[--subscription]
範例
擷取 DNS 轉送規則集
az dns-resolver forwarding-ruleset show --name "sampleDnsForwardingRuleset" --resource-group "sampleResourceGroup"
選擇性參數
DNS 轉送規則集的名稱。
一或多個資源識別碼 (以空格分隔)。 它應該是完整資源識別碼,其中包含「資源標識碼」引數的所有資訊。 您應該提供 --ids 或其他「資源識別碼」引數。
資源群組的名稱。 您可以使用 az configure --defaults group=<name>
來設定預設群組。
訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID
設定預設訂用帳戶。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID
設定預設訂用帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。
az dns-resolver forwarding-ruleset update
更新 DNS 轉送規則集。
az dns-resolver forwarding-ruleset update [--add]
[--dns-forwarding-ruleset-name]
[--force-string {0, 1, f, false, n, no, t, true, y, yes}]
[--ids]
[--if-match]
[--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
[--remove]
[--resource-group]
[--set]
[--subscription]
[--tags]
範例
更新 DNS 轉送規則集
az dns-resolver forwarding-ruleset update --name "sampleDnsForwardingRuleset" --tags key1="value1" --resource-group "sampleResourceGroup"
選擇性參數
藉由指定路徑和索引鍵值組,將物件加入物件清單。 範例:--add property.listProperty <key=value, string or JSON string>
。
DNS 轉送規則集的名稱。
使用 'set' 或 'add' 時,請保留字串常值,而不是嘗試轉換成 JSON。
一或多個資源識別碼 (以空格分隔)。 它應該是完整資源識別碼,其中包含「資源標識碼」引數的所有資訊。 您應該提供 --ids 或其他「資源識別碼」引數。
資源的 ETag。 請省略此值以一律覆寫目前的資源。 指定最後看到的 ETag 值,以防止意外覆寫任何並行變更。
請勿等候長時間執行的作業完成。
從清單中移除屬性或專案。 範例: --remove property.list <indexToRemove>
或 --remove propertyToRemove
。
資源群組的名稱。 您可以使用 az configure --defaults group=<name>
來設定預設群組。
指定要設定的屬性路徑和值,以更新物件。 範例:--set property1.property2=<value>
。
訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID
設定預設訂用帳戶。
以空格分隔的標記:key[=value] [key[=value] ...]。支援速記語法、json-file 和 yaml-file。 請嘗試 “??” 以顯示更多。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID
設定預設訂用帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。
az dns-resolver forwarding-ruleset wait
將 CLI 置於等候狀態,直到符合條件為止。
az dns-resolver forwarding-ruleset wait [--created]
[--custom]
[--deleted]
[--dns-forwarding-ruleset-name]
[--exists]
[--ids]
[--interval]
[--resource-group]
[--subscription]
[--timeout]
[--updated]
選擇性參數
請等候在 'Succeeded' 使用 'provisioningState' 建立。
等到條件符合自定義 JMESPath 查詢為止。 例如 provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running']。
等到刪除為止。
DNS 轉送規則集的名稱。
等候資源存在。
一或多個資源識別碼 (以空格分隔)。 它應該是完整資源識別碼,其中包含「資源標識碼」引數的所有資訊。 您應該提供 --ids 或其他「資源識別碼」引數。
輪詢間隔以秒為單位。
資源群組的名稱。 您可以使用 az configure --defaults group=<name>
來設定預設群組。
訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID
設定預設訂用帳戶。
以秒為單位的等候上限。
等到 provisioningState 更新為 'Succeeded'。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID
設定預設訂用帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。