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.

명령

Name Description 형식 상태
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 인 경우 --target-type 필수입니다.

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

'Succeeded'에서 'provisioningState'를 사용하여 생성될 때까지 기다립니다.

기본값: False
--custom

조건이 사용자 지정 JMESPath 쿼리를 충족할 때까지 기다립니다. 예: provisioningState!='InProgress', instanceView. 상태es[?code=='PowerState/running'].

--deleted

삭제될 때까지 기다립니다.

기본값: False
--exists

리소스가 존재할 때까지 기다립니다.

기본값: False
--ids

하나 이상의 리소스 ID(공백으로 구분)입니다. '리소스 ID' 인수의 모든 정보를 포함하는 전체 리소스 ID여야 합니다. --ids 또는 다른 '리소스 ID' 인수를 제공해야 합니다.

--interval

폴링 간격(초)입니다.

기본값: 30
--name -n

패킷 캡처 세션의 이름입니다.

--subscription

구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.

--timeout

최대 대기 시간(초)입니다.

기본값: 3600
--updated

'Succeeded'에서 provisioningState로 업데이트될 때까지 기다립니다.

기본값: 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를 사용합니다.