az dns-resolver forwarding-ruleset

Note

このリファレンスは、Azure CLI (バージョン 2.39.0 以降) の dns リゾルバー拡張機能の一部です。 拡張機能は、az dns-resolver forwarding-ruleset コマンドを初めて実行するときに自動的にインストールされます。 拡張機能の詳細をご覧ください。

DNS リゾルバーを使用して転送ルール セットを管理します。

コマンド

名前	説明	型	Status
az dns-resolver forwarding-ruleset create	DNS 転送ルール セットを作成します。	拡張	GA
az dns-resolver forwarding-ruleset delete	DNS 転送ルール セットを削除します。 警告: この操作を元に戻すことはできません。 ルール セット内のすべての転送ルールが削除されます。	拡張	GA
az dns-resolver forwarding-ruleset list	仮想ネットワークに接続されている DNS 転送ルールセット リソース ID を一覧表示します。 また、リソース グループ内の DNS 転送ルールセットを一覧表示します。 また、サブスクリプションのすべてのリソース グループの DNS 転送ルールセットを一覧表示します。	拡張	GA
az dns-resolver forwarding-ruleset list-by-virtual-network	仮想ネットワークに接続されている DNS 転送ルールセット リソース ID を一覧表示します。	拡張	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]

例

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-forwarding-ruleset-name --name -n

DNS 転送ルール セットの名前。

--outbound-endpoints

ルールセット内の転送ルールに一致する DNS クエリをターゲット DNS サーバーにルーティングするために使用される DNS リゾルバー送信エンドポイントへの参照。 短縮構文、json-file、yaml-file をサポートします。 詳細を表示するには、"??" を試してください。

--resource-group -g

リソース グループの名前。 az configure --defaults group=<name> を使用して、既定のグループを構成できます。

省略可能のパラメーター

--if-match

リソースの ETag。 現在のリソースを常に上書きするには、この値を省略します。 同時変更が誤って上書きされないように、最後に表示された ETag 値を指定します。

--if-none-match

新しいリソースの作成を許可するが、既存のリソースの更新を禁止するには、'*' に設定します。 その他の値は無視されます。

--location -l

場所。 値のソース: az account list-locations az configure --defaults location=<location> を使用して、既定の場所を構成できます。 指定しない場合は、リソース グループの場所が使用されます。

--no-wait

実行時間の長い操作の終了を待機しません。

承認された値: 0, 1, f, false, n, no, t, true, y, yes

--tags

スペース区切りのタグ: key[=value] [key[=value] ...]短縮構文、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-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-forwarding-ruleset-name --name -n

DNS 転送ルール セットの名前。

--ids

1 つまたは複数のリソース ID (スペース区切り)。 これは、'Resource Id' 引数のすべての情報を含む完全なリソース ID である必要があります。 --ids または他の 'Resource Id' 引数を指定する必要があります。

--if-match

リソースの ETag。 現在のリソースを常に上書きするには、この値を省略します。 同時変更が誤って上書きされないように、最後に表示された ETag 値を指定します。

--no-wait

実行時間の長い操作の終了を待機しません。

承認された値: 0, 1, f, false, n, no, t, true, y, yes

--resource-group -g

リソース グループの名前。 az configure --defaults group=<name> を使用して、既定のグループを構成できます。

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

仮想ネットワークに接続されている DNS 転送ルールセット リソース ID を一覧表示します。 また、リソース グループ内の 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

省略可能のパラメーター

--resource-group -g

リソース グループの名前。 az configure --defaults group=<name> を使用して、既定のグループを構成できます。

--top

返される結果の最大数。 指定しない場合は、最大 100 件の結果を返します。

--virtual-network-name

仮想ネットワークの名前。

グローバル パラメーター

--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-ruleset list-by-virtual-network

仮想ネットワークに接続されている DNS 転送ルールセット リソース ID を一覧表示します。

az dns-resolver forwarding-ruleset list-by-virtual-network --resource-group
                                                           --virtual-network-name
                                                           [--top]

例

仮想ネットワーク別に DNS 転送ルールセットを一覧表示する

az dns-resolver forwarding-ruleset list --resource-group "sampleResourceGroup" --virtual- network-name "sampleVirtualNetwork"

必須のパラメーター

--resource-group -g

リソース グループの名前。 az configure --defaults group=<name> を使用して、既定のグループを構成できます。

--virtual-network-name

仮想ネットワークの名前。

省略可能のパラメーター

--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-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-forwarding-ruleset-name --name -n

DNS 転送ルール セットの名前。

--ids

1 つまたは複数のリソース ID (スペース区切り)。 これは、'Resource Id' 引数のすべての情報を含む完全なリソース ID である必要があります。 --ids または他の 'Resource Id' 引数を指定する必要があります。

--resource-group -g

リソース グループの名前。 az configure --defaults group=<name> を使用して、既定のグループを構成できます。

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

DNS 転送ルール セットを更新します。

az dns-resolver forwarding-ruleset update [--dns-forwarding-ruleset-name]
                                          [--ids]
                                          [--if-match]
                                          [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                          [--resource-group]
                                          [--subscription]
                                          [--tags]

例

DNS 転送ルール セットを更新する

az dns-resolver forwarding-ruleset update --name "sampleDnsForwardingRuleset" --tags key1="value1" --resource-group "sampleResourceGroup"

省略可能のパラメーター

--dns-forwarding-ruleset-name --name -n

DNS 転送ルール セットの名前。

--ids

1 つまたは複数のリソース ID (スペース区切り)。 これは、'Resource Id' 引数のすべての情報を含む完全なリソース ID である必要があります。 --ids または他の 'Resource Id' 引数を指定する必要があります。

--if-match

リソースの ETag。 現在のリソースを常に上書きするには、この値を省略します。 同時変更が誤って上書きされないように、最後に表示された ETag 値を指定します。

--no-wait

実行時間の長い操作の終了を待機しません。

承認された値: 0, 1, f, false, n, no, t, true, y, yes

--resource-group -g

リソース グループの名前。 az configure --defaults group=<name> を使用して、既定のグループを構成できます。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--tags

スペース区切りのタグ: key[=value] [key[=value] ...]短縮構文、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-ruleset wait

条件が満たされるまで CLI を待機状態にします。

az dns-resolver forwarding-ruleset wait [--created]
                                        [--custom]
                                        [--deleted]
                                        [--dns-forwarding-ruleset-name]
                                        [--exists]
                                        [--ids]
                                        [--interval]
                                        [--resource-group]
                                        [--subscription]
                                        [--timeout]
                                        [--updated]

省略可能のパラメーター

--created

'provisioningState' が 'Succeeded' で作成されるまで待ちます。

既定値: False

--custom

条件がカスタム JMESPath クエリを満たすまで待ちます。 例: provisioningState!='InProgress'、instanceView.statuses[?code=='PowerState/running']。

--deleted

削除されるまで待ちます。

既定値: False

--dns-forwarding-ruleset-name --name -n

DNS 転送ルール セットの名前。

--exists

リソースが存在するまで待ちます。

既定値: False

--ids

1 つまたは複数のリソース ID (スペース区切り)。 これは、'Resource Id' 引数のすべての情報を含む完全なリソース ID である必要があります。 --ids または他の 'Resource Id' 引数を指定する必要があります。

--interval

ポーリング間隔 (秒単位)。

既定値: 30

--resource-group -g

リソース グループの名前。 az configure --defaults group=<name> を使用して、既定のグループを構成できます。

--subscription

サブスクリプションの名前または ID。 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

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。