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

az dns-resolver forwarding-rule

参考

注意

此参考是 Azure CLI（版本 2.39.0 或更高版本）的 dns 解析程序扩展的一部分。该扩展将在首次运行 az dns-resolver forwarding-rule 命令时自动安装。详细了解扩展。

使用 dns 解析程序管理转发规则。

命令

名称	说明	类型	状态
az dns-resolver forwarding-rule create	在 DNS 转发规则集中创建转发规则。	扩展	GA
az dns-resolver forwarding-rule delete	删除 DNS 转发规则集中的转发规则。警告：此操作无法撤消。	分机	GA
az dns-resolver forwarding-rule list	列出 DNS 转发规则集中的转发规则。	分机	GA
az dns-resolver forwarding-rule show	获取 DNS 转发规则集中转发规则的属性。	分机	GA
az dns-resolver forwarding-rule update	更新 DNS 转发规则集中的转发规则。	扩展	GA

az dns-resolver forwarding-rule create

在 DNS 转发规则集中创建转发规则。

az dns-resolver forwarding-rule create --domain-name
                                       --forwarding-rule-name
                                       --resource-group
                                       --ruleset-name
                                       --target-dns-servers
                                       [--forwarding-rule-state {Disabled, Enabled}]
                                       [--if-match]
                                       [--if-none-match]
                                       [--metadata]

示例

DNS 转发规则集中的 Upsert 转发规则

az dns-resolver forwarding-rule create --ruleset-name "sampleDnsForwardingRuleset" --name "sampleForwardingRule" --domain-name "contoso.com." --forwarding-rule-state "Enabled" --metadata additionalProp1="value1" --target-dns-servers [{ip-address:"10.0.0.1",port:53},{ip-address:"10.0.0.2",port:53}] --resource-group "sampleResourceGroup"

必需参数

--domain-name

转发规则的域名。

--forwarding-rule-name --name -n

转发规则的名称。

--resource-group -g

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

--ruleset-name

DNS 转发规则集的名称。

--target-dns-servers

要将 DNS 查询转发到的 DNS 服务器。支持速记语法、json-file 和 yaml-file。请尝试“？？” 以显示更多内容。

可选参数

--forwarding-rule-state

转发规则的状态。

接受的值: Disabled, Enabled

--if-match

资源的 ETag。省略此值以始终覆盖当前资源。指定最后一次看到的 ETag 值，以防止意外覆盖任何并发更改。

--if-none-match

设置为“*”以允许创建新资源，但要防止更新现有资源。将忽略其他值。

--metadata

附加到转发规则的元数据。预期值：KEY1=VALUE1 KEY2=VALUE2 ...支持速记语法、json-file 和 yaml-file。请尝试“？？” 以显示更多内容。

全局参数

--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 dns-resolver forwarding-rule delete

删除 DNS 转发规则集中的转发规则。警告：此操作无法撤消。

az dns-resolver forwarding-rule delete [--forwarding-rule-name]
                                       [--ids]
                                       [--if-match]
                                       [--resource-group]
                                       [--ruleset-name]
                                       [--subscription]
                                       [--yes]

示例

删除 DNS 转发规则集中的转发规则

az dns-resolver forwarding-rule delete --ruleset-name "sampleDnsForwardingRuleset" --name "sampleForwardingRule" --resource-group "sampleResourceGroup"

可选参数

--forwarding-rule-name --name -n

转发规则的名称。

--ids

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

--if-match

资源的 ETag。省略此值以始终覆盖当前资源。指定最后一次看到的 ETag 值，以防止意外覆盖任何并发更改。

--resource-group -g

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

--ruleset-name

DNS 转发规则集的名称。

--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 dns-resolver forwarding-rule list

列出 DNS 转发规则集中的转发规则。

az dns-resolver forwarding-rule list --resource-group
                                     --ruleset-name
                                     [--top]

示例

列出 DNS 转发规则集中的转发规则

az dns-resolver forwarding-rule list --ruleset-name "sampleDnsForwardingRuleset" --resource- group "sampleResourceGroup"

必需参数

--resource-group -g

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

--ruleset-name

DNS 转发规则集的名称。

可选参数

--top

要返回的最大结果数。如果未指定，则最多返回 100 个结果。

全局参数

--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 dns-resolver forwarding-rule show

获取 DNS 转发规则集中转发规则的属性。

az dns-resolver forwarding-rule show [--forwarding-rule-name]
                                     [--ids]
                                     [--resource-group]
                                     [--ruleset-name]
                                     [--subscription]

示例

检索 DNS 转发规则集中的转发规则

az dns-resolver forwarding-rule show --ruleset-name "sampleDnsForwardingRuleset" --name "sampleForwardingRule" --resource-group "sampleResourceGroup"

可选参数

--forwarding-rule-name --name -n

转发规则的名称。

--ids

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

--resource-group -g

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

--ruleset-name

DNS 转发规则集的名称。

--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 dns-resolver forwarding-rule update

更新 DNS 转发规则集中的转发规则。

az dns-resolver forwarding-rule update [--forwarding-rule-name]
                                       [--forwarding-rule-state {Disabled, Enabled}]
                                       [--ids]
                                       [--if-match]
                                       [--metadata]
                                       [--resource-group]
                                       [--ruleset-name]
                                       [--subscription]
                                       [--target-dns-servers]

示例

更新 DNS 转发规则集中的转发规则

az dns-resolver forwarding-rule update --ruleset-name "sampleDnsForwardingRuleset" --name "sampleForwardingRule" --forwarding-rule-state "Disabled" --metadata additionalProp2="value2" --resource-group "sampleResourceGroup"

可选参数

--forwarding-rule-name --name -n

转发规则的名称。

--forwarding-rule-state

转发规则的状态。

接受的值: Disabled, Enabled

--ids

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

--if-match

资源的 ETag。省略此值以始终覆盖当前资源。指定最后一次看到的 ETag 值，以防止意外覆盖任何并发更改。

--metadata

附加到转发规则的元数据。预期值：KEY1=VALUE1 KEY2=VALUE2 ...支持速记语法、json-file 和 yaml-file。请尝试“？？” 以显示更多内容。

--resource-group -g

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

--ruleset-name

DNS 转发规则集的名称。

--subscription

订阅的名称或 ID。可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--target-dns-servers

要将 DNS 查询转发到的 DNS 服务器。支持速记语法、json-file 和 yaml-file。请尝试“？？” 以显示更多内容。

全局参数

--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 dns-resolver forwarding-rule

命令

az dns-resolver forwarding-rule create

示例

必需参数

可选参数

az dns-resolver forwarding-rule delete

示例

可选参数

az dns-resolver forwarding-rule list

示例

必需参数

可选参数

az dns-resolver forwarding-rule show

示例

可选参数

az dns-resolver forwarding-rule update

示例

可选参数

反馈

其他资源