az network watcher packet-capture

Gerencie sessões de captura de pacotes em VMs.

Esses comandos exigem que o Observador de Rede do Azure esteja habilitado para a região de VMs e que AzureNetworkWatcherExtension esteja habilitado na VM. Para obter 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.	Core	GA
az network watcher packet-capture delete	Exclua uma sessão de captura de pacotes.	Core	GA
az network watcher packet-capture list	Liste todas as sessões de captura de pacotes em uma região.	Core	GA
az network watcher packet-capture show	Mostrar detalhes de uma sessão de captura de pacotes.	Core	GA
az network watcher packet-capture show-status	Mostre o status de uma sessão de captura de pacotes.	Core	GA
az network watcher packet-capture stop	Pare uma sessão de captura de pacotes em execução.	Core	GA
az network watcher packet-capture wait	Coloque a CLI em um estado de espera até que uma condição seja atendida.	Core	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 pacote 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ço IP local e intervalos de endereços IP remotos e portas.

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

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--capture-limit

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

Propriedade	Valor
Valor padrão:	1073741824

--capture-size

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

Propriedade	Valor
Valor padrão:	0

--exclude

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

Propriedade	Valor
Grupo de parâmetros:	Scope Arguments

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

Propriedade	Valor
Grupo de parâmetros:	Storage Arguments

--filters

Lista codificada em JSON de filtros de pacote. Use @{path} para carregar do arquivo. Suporte a sintaxe abreviada, arquivo json e yaml-file. Tente "??" para mostrar mais.

--include

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

Propriedade	Valor
Grupo de parâmetros:	Scope Arguments

--no-wait

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

Propriedade	Valor
Valores aceitos:	0, 1, f, false, n, no, t, true, y, yes

--storage-account

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

Propriedade	Valor
Grupo de parâmetros:	Storage Arguments

--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 ele não existir e o arquivo de captura será armazenado lá.

Propriedade	Valor
Grupo de parâmetros:	Storage Arguments

--target

Nome ou ID do recurso de destino. Se --target-type for AzureVMSS, --target será obrigatório.

--target-type

Tipo de recurso de destino.

Propriedade	Valor
Valor padrão:	AzureVM
Valores aceitos:	AzureVM, AzureVMSS

--time-limit

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

Propriedade	Valor
Valor padrão:	18000

--vm

Nome ou ID da VM a ser direcionada.

Parâmetros Globais

--debug

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

Propriedade	Valor
Valor padrão:	False

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Valor padrão:	False

--output -o

Formato de saída.

Propriedade	Valor
Valor padrão:	json
Valores aceitos:	json, jsonc, none, table, tsv, yaml, yamlc

--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 a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade	Valor
Valor padrão:	False

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

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

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--no-wait

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

Propriedade	Valor
Valores aceitos:	0, 1, f, false, n, no, t, true, y, yes

Parâmetros Globais

--debug

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

Propriedade	Valor
Valor padrão:	False

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Valor padrão:	False

--output -o

Formato de saída.

Propriedade	Valor
Valor padrão:	json
Valores aceitos:	json, jsonc, none, table, tsv, yaml, yamlc

--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 a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade	Valor
Valor padrão:	False

az network watcher packet-capture list

Editar

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

az network watcher packet-capture list --location

Exemplos

Liste 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

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

Parâmetros Globais

--debug

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

Propriedade	Valor
Valor padrão:	False

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Valor padrão:	False

--output -o

Formato de saída.

Propriedade	Valor
Valor padrão:	json
Valores aceitos:	json, jsonc, none, table, tsv, yaml, yamlc

--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 a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade	Valor
Valor padrão:	False

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

Location. 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 a verbosidade de log para mostrar todos os logs de depuração.

Propriedade	Valor
Valor padrão:	False

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Valor padrão:	False

--output -o

Formato de saída.

Propriedade	Valor
Valor padrão:	json
Valores aceitos:	json, jsonc, none, table, tsv, yaml, yamlc

--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 a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade	Valor
Valor padrão:	False

az network watcher packet-capture show-status

Editar

Mostre 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

Mostre 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

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

--name -n

Nome fornecido para a sessão de captura de pacotes.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--no-wait

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

Propriedade	Valor
Valores aceitos:	0, 1, f, false, n, no, t, true, y, yes

Parâmetros Globais

--debug

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

Propriedade	Valor
Valor padrão:	False

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Valor padrão:	False

--output -o

Formato de saída.

Propriedade	Valor
Valor padrão:	json
Valores aceitos:	json, jsonc, none, table, tsv, yaml, yamlc

--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 a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade	Valor
Valor padrão:	False

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

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

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--no-wait

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

Propriedade	Valor
Valores aceitos:	0, 1, f, false, n, no, t, true, y, yes

Parâmetros Globais

--debug

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

Propriedade	Valor
Valor padrão:	False

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Valor padrão:	False

--output -o

Formato de saída.

Propriedade	Valor
Valor padrão:	json
Valores aceitos:	json, jsonc, none, table, tsv, yaml, yamlc

--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 a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade	Valor
Valor padrão:	False

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

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--created

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

Propriedade	Valor
Grupo de parâmetros:	Wait Condition Arguments
Valor padrão:	False

--custom

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

Propriedade	Valor
Grupo de parâmetros:	Wait Condition Arguments

--deleted

Aguarde até ser excluído.

Propriedade	Valor
Grupo de parâmetros:	Wait Condition Arguments
Valor padrão:	False

--exists

Aguarde até que o recurso exista.

Propriedade	Valor
Grupo de parâmetros:	Wait Condition Arguments
Valor padrão:	False

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de 'ID do recurso'. Você deve fornecer --ids ou outros argumentos de 'ID de recurso'.

Propriedade	Valor
Grupo de parâmetros:	Resource Id Arguments

--interval

Intervalo de sondagem em segundos.

Propriedade	Valor
Grupo de parâmetros:	Wait Condition Arguments
Valor padrão:	30

--name -n

Nome da sessão de captura de pacotes.

Propriedade	Valor
Grupo de parâmetros:	Resource Id Arguments

--subscription

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

Propriedade	Valor
Grupo de parâmetros:	Resource Id Arguments

--timeout

Espera máxima em segundos.

Propriedade	Valor
Grupo de parâmetros:	Wait Condition Arguments
Valor padrão:	3600

--updated

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

Propriedade	Valor
Grupo de parâmetros:	Wait Condition Arguments
Valor padrão:	False

--watcher-name

Nome do observador de rede.

Propriedade	Valor
Grupo de parâmetros:	Resource Id Arguments

--watcher-rg

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

Propriedade	Valor
Grupo de parâmetros:	Resource Id Arguments

Parâmetros Globais

--debug

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

Propriedade	Valor
Valor padrão:	False

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Valor padrão:	False

--output -o

Formato de saída.

Propriedade	Valor
Valor padrão:	json
Valores aceitos:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--verbose

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

Propriedade	Valor
Valor padrão:	False

Comentários

Esta página foi útil?

Compartilhar via

az network watcher packet-capture

Comandos

az network watcher packet-capture create

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

az network watcher packet-capture delete

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

az network watcher packet-capture list

Exemplos

Parâmetros Exigidos

az network watcher packet-capture show

Exemplos

Parâmetros Exigidos

az network watcher packet-capture show-status

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

az network watcher packet-capture stop

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

az network watcher packet-capture wait

Parâmetros Opcionais

Comentários