Compartilhar via

az network watcher packet-capture

  • Referência

Gerenciar sessões de captura de pacotes em VMs.

Esses comandos exigem que o Inspetor de Rede do Azure esteja habilitado para a região de 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

Nome Description Tipo Status
az network watcher packet-capture create

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

 Núcleo GA
az network watcher packet-capture delete

Exclua uma sessão de captura de pacotes.

 Núcleo GA
az network watcher packet-capture list

Listar todas as sessões de captura de pacotes em uma região.

 Núcleo GA
az network watcher packet-capture show

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

 Núcleo GA
az network watcher packet-capture show-status

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

 Núcleo GA
az network watcher packet-capture stop

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

 Núcleo GA
az network watcher packet-capture wait

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

 Núcleo 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 a 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 Exigidos

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

Valor padrão: 1073741824
--capture-size

Número de bytes capturados por pacote. O excesso de bytes é truncado.

Valor padrão: 0
--exclude

Lista separada por espaço de instâncias VMSS a serem excluídas na captura de pacotes. Suporte taquigráfico-sintaxe, 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 em JSON de filtros de pacotes. Use @{path} para carregar do arquivo. Suporte taquigráfico-sintaxe, 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. Suporte taquigráfico-sintaxe, json-file e yaml-file. Tente "??" para mostrar mais.

--no-wait

Não aguarde a conclusão da operação de execução longa.

Valores aceitos: 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 pacotes.

--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 aceitos: AzureVM, AzureVMSS
Valor padrão: AzureVM
--time-limit

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

Valor padrão: 18000
--vm

Nome ou ID da VM a ser direcionada.

Parâmetros Globais
--debug

Aumente o detalhamento 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 aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

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

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. 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 Exigidos

--location -l

Local. 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 aguarde a conclusão da operação de execução longa.

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

Aumente o detalhamento 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 aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

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

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az network watcher packet-capture list

Editar

Listar todas as sessões de captura de pacotes em uma região.

az network watcher packet-capture list --location

Exemplos

Listar todas as sessões de captura de pacotes em uma região.

az az network watcher packet-capture list -l westus

Parâmetros Exigidos

--location -l

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

Parâmetros Globais
--debug

Aumente o detalhamento 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 aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

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

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. 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 Exigidos

--location -l

Local. 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 Globais
--debug

Aumente o detalhamento 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 aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

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

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. 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 Exigidos

--location -l

Local. 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 aguarde a conclusão da operação de execução longa.

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

Aumente o detalhamento 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 aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

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

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. 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 Exigidos

--location -l

Local. 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 aguarde a conclusão da operação de execução longa.

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

Aumente o detalhamento 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 aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

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

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. 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é criar com 'provisioningState' em 'Succeeded'.

Valor padrão: 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.

Valor padrão: False
--exists

Aguarde até que o recurso exista.

Valor padrão: False
--ids

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

--interval

Intervalo de sondagem em segundos.

Valor padrão: 30
--name -n

Nome da sessão de captura de pacotes.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--timeout

Espera máxima em segundos.

Valor padrão: 3600
--updated

Aguarde até que seja atualizado com provisioningState em 'Succeeded'.

Valor padrão: False
--watcher-name

Nome do observador da rede.

--watcher-rg

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

Parâmetros Globais
--debug

Aumente o detalhamento 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 aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

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

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.