Partilhar via

az network watcher packet-capture

  • Referência

Gerencie sessões de captura de pacotes em VMs.

Esses comandos exigem que o Azure Network Watcher esteja habilitado para a região VMs e que AzureNetworkWatcherExtension esteja habilitado na VM. Para mais informações, visite https://learn.microsoft.com/en-us/azure/network-watcher/network-watcher-packet-capture-manage-cli.

Comandos

Name Description Tipo Status
az network watcher packet-capture create

Crie e inicie uma sessão de captura de pacotes.

 Principal GA
az network watcher packet-capture delete

Exclua uma sessão de captura de pacotes.

 Principal GA
az network watcher packet-capture list

Liste todas as sessões de captura de pacotes dentro de uma região.

 Principal GA
az network watcher packet-capture show

Mostrar detalhes de uma sessão de captura de pacotes.

 Principal GA
az network watcher packet-capture show-status

Mostrar o status de uma sessão de captura de pacotes.

 Principal GA
az network watcher packet-capture stop

Pare uma sessão de captura de pacotes em execução.

 Principal GA
az network watcher packet-capture wait

Coloque a CLI em um estado de espera até que uma condição seja atendida.

 Principal GA

az network watcher packet-capture create

Editar

Crie e inicie uma sessão de captura de pacotes.

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]

Exemplos

Crie uma sessão de captura de pacotes em uma VM.

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

Crie uma sessão de captura de pacotes em uma VM com filtros opcionais para protocolos, endereços IP locais e intervalos e portas de endereços IP remotos.

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"}]'

Crie uma sessão de captura de pacotes em um VMSS.

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

Crie uma sessão de captura de pacotes em um VMSS com a inclusão de instâncias específicas.

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

Crie uma sessão de captura de pacotes em um VMSS com exclusão de instâncias específicas.

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

Parâmetros Obrigatórios

--name -n

Nome da sessão de captura de pacotes.

--resource-group -g

Nome do grupo de recursos em que o recurso de destino está.

Parâmetros Opcionais

--capture-limit

Tamanho máximo em bytes da saída de captura.

Default value: 1073741824
--capture-size

Número de bytes capturados por pacote. Os bytes em excesso são truncados.

Default value: 0
--exclude

Lista separada por espaço de instâncias VMSS a serem excluídas na captura de pacotes. Suporta sintaxe taquigráfica, json-file e yaml-file. Tente "??" para mostrar mais.

--file-path

Caminho local na VM de destino na qual salvar a captura de pacote. Para VMs Linux, o caminho deve começar com /var/captures.

--filters

Lista codificada JSON de filtros de pacotes. Use @{path} para carregar a partir do arquivo. Suporta sintaxe taquigráfica, json-file e yaml-file. Tente "??" para mostrar mais.

--include

Lista separada por espaço de instâncias VMSS a serem incluídas na captura de pacotes, como 0, 1, 2. Suporta sintaxe taquigráfica, json-file e yaml-file. Tente "??" para mostrar mais.

--no-wait

Não espere que a operação de longa duração termine.

Valores aceites: 0, 1, f, false, n, no, t, true, y, yes
--storage-account

Nome ou ID de uma conta de armazenamento na qual salvar a captura de pacote.

--storage-path

URI totalmente qualificado de um contêiner de armazenamento existente no qual armazenar o arquivo de captura. Se não for especificado, o contêiner network-watcher-logs será criado se não existir e o arquivo de captura será armazenado lá.

--target

Nome ou ID do recurso de destino. Se --target-type for AzureVMSS, então --target é obrigatório.

--target-type

Tipo de recurso de destino.

Valores aceites: AzureVM, AzureVMSS
Default value: AzureVM
--time-limit

Duração máxima da sessão de captura em segundos.

Default value: 18000
--vm

Nome ou ID da VM de destino.

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az network watcher packet-capture delete

Editar

Exclua uma sessão de captura de pacotes.

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

Exemplos

Exclua uma sessão de captura de pacotes. Isso exclui apenas a sessão e não o arquivo de captura.

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

Parâmetros Obrigatórios

--location -l

Localização. Valores de: az account list-locations. Você pode configurar o local padrão usando az configure --defaults location=<location>.

--name -n

Nome da sessão de captura de pacotes.

Parâmetros Opcionais

--no-wait

Não espere que a operação de longa duração termine.

Valores aceites: 0, 1, f, false, n, no, t, true, y, yes
Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az network watcher packet-capture list

Editar

Liste todas as sessões de captura de pacotes dentro de uma região.

az network watcher packet-capture list --location

Exemplos

Liste todas as sessões de captura de pacotes dentro de uma região.

az az network watcher packet-capture list -l westus

Parâmetros Obrigatórios

--location -l

Localização. Valores de: az account list-locations. Você pode configurar o local padrão usando az configure --defaults location=<location>.

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az network watcher packet-capture show

Editar

Mostrar detalhes de uma sessão de captura de pacotes.

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

Exemplos

Mostrar uma sessão de captura de pacotes.

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

Parâmetros Obrigatórios

--location -l

Localização. Valores de: az account list-locations. Você pode configurar o local padrão usando az configure --defaults location=<location>.

--name -n

Nome da sessão de captura de pacotes.

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az network watcher packet-capture show-status

Editar

Mostrar o status de uma sessão de captura de pacotes.

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

Exemplos

Mostrar o status de uma sessão de captura de pacotes.

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

Parâmetros Obrigatórios

--location -l

Localização. Valores de: az account list-locations. Você pode configurar o local padrão usando az configure --defaults location=<location>.

--name -n

Nome dado à sessão de captura de pacotes.

Parâmetros Opcionais

--no-wait

Não espere que a operação de longa duração termine.

Valores aceites: 0, 1, f, false, n, no, t, true, y, yes
Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az network watcher packet-capture stop

Editar

Pare uma sessão de captura de pacotes em execução.

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

Exemplos

Pare uma sessão de captura de pacotes em execução.

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

Parâmetros Obrigatórios

--location -l

Localização. Valores de: az account list-locations. Você pode configurar o local padrão usando az configure --defaults location=<location>.

--name -n

Nome da sessão de captura de pacotes.

Parâmetros Opcionais

--no-wait

Não espere que a operação de longa duração termine.

Valores aceites: 0, 1, f, false, n, no, t, true, y, yes
Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az network watcher packet-capture wait

Editar

Coloque a CLI em um estado de espera até que uma condição seja atendida.

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

Parâmetros Opcionais

--created

Aguarde até ser criado com 'provisioningState' em 'Succeeded'.

Default value: False
--custom

Aguarde até que a condição satisfaça uma consulta JMESPath personalizada. Por exemplo, provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Aguarde até ser excluído.

Default value: False
--exists

Aguarde até que o recurso exista.

Default value: False
--ids

Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'ID do recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--interval

Intervalo de sondagem em segundos.

Default value: 30
--name -n

Nome da sessão de captura de pacotes.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--timeout

Espera máxima em segundos.

Default value: 3600
--updated

Aguarde até ser atualizado com provisioningState em 'Succeeded'.

Default value: False
--watcher-name

Nome do observador de rede.

--watcher-rg

Nome do grupo de recursos em que o inspetor está.

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.