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

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

オプションのパラメーター

次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。

--capture-limit

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

プロパティ	値
規定値:	1073741824

--capture-size

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

プロパティ	値
規定値:	0

--exclude

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

プロパティ	値
パラメーターグループ:	Scope Arguments

--file-path

パケットキャプチャを保存するターゲット VM 上のローカルパス。 Linux VM の場合、パスは /var/capturesで始まる必要があります。

プロパティ	値
パラメーターグループ:	Storage Arguments

--filters

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

--include

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

プロパティ	値
パラメーターグループ:	Scope Arguments

--no-wait

実行時間の長い操作が完了するまで待つ必要はありません。

プロパティ	値
指定可能な値:	0, 1, f, false, n, no, t, true, y, yes

--storage-account

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

プロパティ	値
パラメーターグループ:	Storage Arguments

--storage-path

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

プロパティ	値
パラメーターグループ:	Storage Arguments

--target

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

--target-type

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

プロパティ	値
規定値:	AzureVM
指定可能な値:	AzureVM, AzureVMSS

--time-limit

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

プロパティ	値
規定値:	18000

--vm

ターゲットとなる VM の名前または ID。

グローバルパラメーター

--debug

ログの詳細度を上げて、すべてのデバッグログを表示します。

プロパティ	値
規定値:	False

--help -h

このヘルプメッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告を抑制します。

プロパティ	値
規定値:	False

--output -o

出力フォーマット。

プロパティ	値
規定値:	json
指定可能な値:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath クエリ文字列。詳細と例については、http://jmespath.org/ を参照してください。

--subscription

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

--verbose

ログの詳細度を高める。完全なデバッグログには --debug を使用します。

プロパティ	値
規定値:	False

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

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

--name -n

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

オプションのパラメーター

次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。

--no-wait

実行時間の長い操作が完了するまで待つ必要はありません。

プロパティ	値
指定可能な値:	0, 1, f, false, n, no, t, true, y, yes

グローバルパラメーター

--debug

ログの詳細度を上げて、すべてのデバッグログを表示します。

プロパティ	値
規定値:	False

--help -h

このヘルプメッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告を抑制します。

プロパティ	値
規定値:	False

--output -o

出力フォーマット。

プロパティ	値
規定値:	json
指定可能な値:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath クエリ文字列。詳細と例については、http://jmespath.org/ を参照してください。

--subscription

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

--verbose

ログの詳細度を高める。完全なデバッグログには --debug を使用します。

プロパティ	値
規定値:	False

az network watcher packet-capture list

編集

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

az network watcher packet-capture list --location

例

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

az az network watcher packet-capture list -l westus

必須のパラメーター

--location -l

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

グローバルパラメーター

--debug

ログの詳細度を上げて、すべてのデバッグログを表示します。

プロパティ	値
規定値:	False

--help -h

このヘルプメッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告を抑制します。

プロパティ	値
規定値:	False

--output -o

出力フォーマット。

プロパティ	値
規定値:	json
指定可能な値:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath クエリ文字列。詳細と例については、http://jmespath.org/ を参照してください。

--subscription

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

--verbose

ログの詳細度を高める。完全なデバッグログには --debug を使用します。

プロパティ	値
規定値:	False

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

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

--name -n

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

グローバルパラメーター

--debug

ログの詳細度を上げて、すべてのデバッグログを表示します。

プロパティ	値
規定値:	False

--help -h

このヘルプメッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告を抑制します。

プロパティ	値
規定値:	False

--output -o

出力フォーマット。

プロパティ	値
規定値:	json
指定可能な値:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath クエリ文字列。詳細と例については、http://jmespath.org/ を参照してください。

--subscription

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

--verbose

ログの詳細度を高める。完全なデバッグログには --debug を使用します。

プロパティ	値
規定値:	False

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

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

--name -n

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

オプションのパラメーター

次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。

--no-wait

実行時間の長い操作が完了するまで待つ必要はありません。

プロパティ	値
指定可能な値:	0, 1, f, false, n, no, t, true, y, yes

グローバルパラメーター

--debug

ログの詳細度を上げて、すべてのデバッグログを表示します。

プロパティ	値
規定値:	False

--help -h

このヘルプメッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告を抑制します。

プロパティ	値
規定値:	False

--output -o

出力フォーマット。

プロパティ	値
規定値:	json
指定可能な値:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath クエリ文字列。詳細と例については、http://jmespath.org/ を参照してください。

--subscription

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

--verbose

ログの詳細度を高める。完全なデバッグログには --debug を使用します。

プロパティ	値
規定値:	False

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

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

--name -n

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

オプションのパラメーター

次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。

--no-wait

実行時間の長い操作が完了するまで待つ必要はありません。

プロパティ	値
指定可能な値:	0, 1, f, false, n, no, t, true, y, yes

グローバルパラメーター

--debug

ログの詳細度を上げて、すべてのデバッグログを表示します。

プロパティ	値
規定値:	False

--help -h

このヘルプメッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告を抑制します。

プロパティ	値
規定値:	False

--output -o

出力フォーマット。

プロパティ	値
規定値:	json
指定可能な値:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath クエリ文字列。詳細と例については、http://jmespath.org/ を参照してください。

--subscription

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

--verbose

ログの詳細度を高める。完全なデバッグログには --debug を使用します。

プロパティ	値
規定値:	False

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]

オプションのパラメーター

次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。

--created

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

プロパティ	値
パラメーターグループ:	Wait Condition Arguments
規定値:	False

--custom

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

プロパティ	値
パラメーターグループ:	Wait Condition Arguments

--deleted

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

プロパティ	値
パラメーターグループ:	Wait Condition Arguments
規定値:	False

--exists

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

プロパティ	値
パラメーターグループ:	Wait Condition Arguments
規定値:	False

--ids

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

プロパティ	値
パラメーターグループ:	Resource Id Arguments

--interval

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

プロパティ	値
パラメーターグループ:	Wait Condition Arguments
規定値:	30

--name -n

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

プロパティ	値
パラメーターグループ:	Resource Id Arguments

--subscription

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

プロパティ	値
パラメーターグループ:	Resource Id Arguments

--timeout

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

プロパティ	値
パラメーターグループ:	Wait Condition Arguments
規定値:	3600

--updated

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

プロパティ	値
パラメーターグループ:	Wait Condition Arguments
規定値:	False

--watcher-name

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

プロパティ	値
パラメーターグループ:	Resource Id Arguments

--watcher-rg

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

プロパティ	値
パラメーターグループ:	Resource Id Arguments

グローバルパラメーター

--debug

ログの詳細度を上げて、すべてのデバッグログを表示します。

プロパティ	値
規定値:	False

--help -h

このヘルプメッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告を抑制します。

プロパティ	値
規定値:	False

--output -o

出力フォーマット。

プロパティ	値
規定値:	json
指定可能な値:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath クエリ文字列。詳細と例については、http://jmespath.org/ を参照してください。

--verbose

ログの詳細度を高める。完全なデバッグログには --debug を使用します。

プロパティ	値
規定値:	False

フィードバック

このページはお役に立ちましたか?

次の方法で共有

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

オプションのパラメーター

フィードバック