az network watcher packet-capture

リファレンス

VM 上のパケットキャプチャセッションを管理します。

これらのコマンドを実行するには、VM リージョンに対して Azure Network Watcher が有効であることと、VM で AzureNetworkWatcherExtension が有効になっている必要があります。詳細については、以下を参照してください https://learn.microsoft.com/en-us/azure/network-watcher/network-watcher-packet-capture-manage-cli。

コマンド

名前	説明	型	状態
az network watcher packet-capture create	パケットキャプチャセッションを作成して開始します。	コア	GA
az network watcher packet-capture delete	パケットキャプチャセッションを削除します。	コア	GA
az network watcher packet-capture list	リージョン内のすべてのパケットキャプチャセッションを一覧表示します。	コア	GA
az network watcher packet-capture show	パケットキャプチャセッションの詳細を表示します。	コア	GA
az network watcher packet-capture show-status	パケットキャプチャセッションの状態を表示します。	コア	GA
az network watcher packet-capture stop	実行中のパケットキャプチャセッションを停止します。	コア	GA
az network watcher packet-capture wait	条件が満たされるまで CLI を待機状態にします。	コア	GA

az network watcher packet-capture create

編集

パケットキャプチャセッションを作成して開始します。

az network watcher packet-capture create --name
                                         --resource-group
                                         [--capture-limit]
                                         [--capture-size]
                                         [--exclude]
                                         [--file-path]
                                         [--filters]
                                         [--include]
                                         [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                         [--storage-account]
                                         [--storage-path]
                                         [--target]
                                         [--target-type {AzureVM, AzureVMSS}]
                                         [--time-limit]
                                         [--vm]

例

VM でパケットキャプチャセッションを作成します。

az network watcher packet-capture create -g MyResourceGroup -n MyPacketCaptureName --vm MyVm --storage-account MyStorageAccount

プロトコル、ローカル IP アドレス、およびリモート IP アドレスの範囲とポートに対するオプションのフィルターを使用して、VM 上にパケットキャプチャセッションを作成します。

az network watcher packet-capture create -g MyResourceGroup -n MyPacketCaptureName --vm MyVm --storage-account MyStorageAccount --filters '[{"protocol":"TCP", "remoteIPAddress":"1.1.1.1-255.255.255", "localIPAddress":"10.0.0.3", "remotePort":"20"}, {"protocol":"TCP", "remoteIPAddress":"1.1.1.1-255.255.255", "localIPAddress":"10.0.0.3", "remotePort":"80"}, {"protocol":"TCP", "remoteIPAddress":"1.1.1.1-255.255.255", "localIPAddress":"10.0.0.3", "remotePort":"443"}, {"protocol":"UDP"}]'

VMSS でパケットキャプチャセッションを作成します。

az network watcher packet-capture create -g MyResourceGroup -n MyPacketCaptureName --vm MyVmVMSS --storage-account MyStorageAccount --target-type "AzureVMSS"

特定のインスタンスを含む VMSS でパケットキャプチャセッションを作成します。

az network watcher packet-capture create -g MyResourceGroup -n MyPacketCaptureName --target MyVmVMSS --storage-account MyStorageAccount --target-type "AzureVMSS" --include "0" "1"

特定のインスタンスを除外した VMSS でパケットキャプチャセッションを作成します。

az network watcher packet-capture create -g MyResourceGroup -n MyPacketCaptureName --vm MyVmVMSS --storage-account MyStorageAccount --target-type "AzureVMSS" --exclude "0" "1"

必須のパラメーター

--name -n

パケットキャプチャセッションの名前。

--resource-group -g

ターゲットリソースが含まれているリソースグループの名前。

省略可能のパラメーター

--capture-limit

キャプチャ出力の最大サイズ (バイト単位)。

規定値: 1073741824

--capture-size

パケットごとにキャプチャされたバイト数。余分なバイトは切り捨てられます。

規定値: 0

--exclude

パケットキャプチャで除外する VMSS インスタンスのスペース区切りの一覧。短縮構文、json-file、yaml-file をサポートします。詳細を表示するには、"??" を試してください。

--file-path

パケットキャプチャを保存するターゲット VM 上のローカルパス。 Linux VM の場合、パスは ./var/captures

--filters

JSON でエンコードされたパケットフィルターの一覧。ファイルから読み込む場合に使用 @{path} します。短縮構文、json-file、yaml-file をサポートします。詳細を表示するには、"??" を試してください。

--include

0 1 2 などのパケットキャプチャに含める VMSS インスタンスのスペース区切りの一覧。短縮構文、json-file、yaml-file をサポートします。詳細を表示するには、"??" を試してください。

--no-wait

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

指定可能な値: 0, 1, f, false, n, no, t, true, y, yes

--storage-account

パケットキャプチャを保存するストレージアカウントの名前または ID。

--storage-path

キャプチャファイルを格納する既存のストレージコンテナーの完全修飾 URI。指定しない場合、コンテナー network-watcher-logs が存在しない場合は作成され、キャプチャファイルはそこに格納されます。

--target

ターゲットリソースの名前または ID。 AzureVMSS の場合 --target-type は必須 --target です。

--target-type

ターゲットのリソースの種類。

指定可能な値: AzureVM, AzureVMSS

規定値: AzureVM

--time-limit

キャプチャセッションの最大期間 (秒単位)。

規定値: 18000

--vm

ターゲットとなる VM の名前または 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 network watcher packet-capture delete

編集

パケットキャプチャセッションを削除します。

az network watcher packet-capture delete --location
                                         --name
                                         [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]

例

パケットキャプチャセッションを削除します。これにより、セッションのみが削除され、キャプチャファイルは削除されません。

az network watcher packet-capture delete -n packetCaptureName -l westcentralus

必須のパラメーター

--location -l

場所。値のソース: az account list-locations az configure --defaults location=<location> を使用して、既定の場所を構成できます。

--name -n

パケットキャプチャセッションの名前。

省略可能のパラメーター

--no-wait

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

指定可能な値: 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

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

--verbose

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

az network watcher packet-capture list

編集

リージョン内のすべてのパケットキャプチャセッションを一覧表示します。

az network watcher packet-capture list --location

例

リージョン内のすべてのパケットキャプチャセッションを一覧表示します。

az az network watcher packet-capture list -l westus

必須のパラメーター

--location -l

場所。値のソース: az account list-locations az configure --defaults location=<location> を使用して、既定の場所を構成できます。

グローバルパラメーター

--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 network watcher packet-capture show

編集

パケットキャプチャセッションの詳細を表示します。

az network watcher packet-capture show --location
                                       --name

例

パケットキャプチャセッションを表示します。

az network watcher packet-capture show -l westus -n MyPacketCapture

必須のパラメーター

--location -l

場所。値のソース: az account list-locations az configure --defaults location=<location> を使用して、既定の場所を構成できます。

--name -n

パケットキャプチャセッションの名前。

グローバルパラメーター

--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 network watcher packet-capture show-status

編集

パケットキャプチャセッションの状態を表示します。

az network watcher packet-capture show-status --location
                                              --name
                                              [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]

例

パケットキャプチャセッションの状態を表示します。

az network watcher packet-capture show-status -l westus -n MyPacketCapture

必須のパラメーター

--location -l

場所。値のソース: az account list-locations az configure --defaults location=<location> を使用して、既定の場所を構成できます。

--name -n

パケットキャプチャセッションに指定された名前。

省略可能のパラメーター

--no-wait

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

指定可能な値: 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

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

--verbose

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

az network watcher packet-capture stop

編集

実行中のパケットキャプチャセッションを停止します。

az network watcher packet-capture stop --location
                                       --name
                                       [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]

例

実行中のパケットキャプチャセッションを停止します。

az network watcher packet-capture stop -l westus -n MyPacketCapture

必須のパラメーター

--location -l

場所。値のソース: az account list-locations az configure --defaults location=<location> を使用して、既定の場所を構成できます。

--name -n

パケットキャプチャセッションの名前。

省略可能のパラメーター

--no-wait

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

指定可能な値: 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

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

--verbose

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

az network watcher packet-capture wait

編集

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

az network watcher packet-capture wait [--created]
                                       [--custom]
                                       [--deleted]
                                       [--exists]
                                       [--ids]
                                       [--interval]
                                       [--name]
                                       [--subscription]
                                       [--timeout]
                                       [--updated]
                                       [--watcher-name]
                                       [--watcher-rg]

省略可能のパラメーター

--created

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

規定値: False

--custom

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

--deleted

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

規定値: False

--exists

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

規定値: False

--ids

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

--interval

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

規定値: 30

--name -n

パケットキャプチャセッションの名前。

--subscription

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

--timeout

最大待機時間 (秒単位)。

規定値: 3600

--updated

provisioningState が 'Succeeded' で更新されるまで待ちます。

規定値: False

--watcher-name

ネットワークウォッチャーの名前。

--watcher-rg

ウォッチャーが含まれているリソースグループの名前。

グローバルパラメーター

--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 network watcher packet-capture

コマンド

az network watcher packet-capture create

例

必須のパラメーター

省略可能のパラメーター

az network watcher packet-capture delete

例

必須のパラメーター

省略可能のパラメーター

az network watcher packet-capture list

例

必須のパラメーター

az network watcher packet-capture show

例

必須のパラメーター

az network watcher packet-capture show-status

例

必須のパラメーター

省略可能のパラメーター

az network watcher packet-capture stop

例

必須のパラメーター

省略可能のパラメーター

az network watcher packet-capture wait

省略可能のパラメーター

その他のリソース