Compartir a través de


az network watcher packet-capture

Administrar sesiones de captura de paquetes en máquinas virtuales.

Estos comandos requieren que Azure Network Watcher esté habilitado para la región de las máquinas virtuales y que AzureNetworkWatcherExtension esté habilitado en la máquina virtual. Para obtener más información, visite https://learn.microsoft.com/en-us/azure/network-watcher/network-watcher-packet-capture-manage-cli.

Comandos

Nombre Description Tipo Estado
az network watcher packet-capture create

Cree e inicie una sesión de captura de paquetes.

Core GA
az network watcher packet-capture delete

Elimine una sesión de captura de paquetes.

Core GA
az network watcher packet-capture list

Enumere todas las sesiones de captura de paquetes dentro de una región.

Core GA
az network watcher packet-capture show

Mostrar detalles de una sesión de captura de paquetes.

Core GA
az network watcher packet-capture show-status

Muestra el estado de una sesión de captura de paquetes.

Core GA
az network watcher packet-capture stop

Detenga una sesión de captura de paquetes en ejecución.

Core GA
az network watcher packet-capture wait

Coloque la CLI en un estado de espera hasta que se cumpla una condición.

Core GA

az network watcher packet-capture create

Cree e inicie una sesión de captura de paquetes.

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]

Ejemplos

Cree una sesión de captura de paquetes en una máquina virtual.

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

Cree una sesión de captura de paquetes en una máquina virtual con filtros opcionales para protocolos, direcciones IP locales y puertos y intervalos de direcciones IP remotas.

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

Cree una sesión de captura de paquetes en un VMSS.

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

Cree una sesión de captura de paquetes en un VMSS con instancias concretas.

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

Cree una sesión de captura de paquetes en un VMSS con la exclusión de instancias concretas.

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

Parámetros requeridos

--name -n

Nombre de la sesión de captura de paquetes.

--resource-group -g

Nombre del grupo de recursos en el que se encuentra el recurso de destino.

Parámetros opcionales

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--capture-limit

Tamaño máximo en bytes de la salida de captura.

Propiedad Valor
Valor predeterminado: 1073741824
--capture-size

Número de bytes capturados por paquete. Se truncan los bytes excesivos.

Propiedad Valor
Valor predeterminado: 0
--exclude

Lista separada por espacios de instancias de VMSS que se van a excluir en la captura de paquetes. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

Propiedad Valor
Parameter group: Scope Arguments
--file-path

Ruta de acceso local en la máquina virtual de destino en la que se va a guardar la captura de paquetes. En el caso de las máquinas virtuales Linux, la ruta de acceso debe comenzar con /var/captures.

Propiedad Valor
Parameter group: Storage Arguments
--filters

Lista codificada de JSON de filtros de paquetes. Use @{path} para cargar desde el archivo. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

--include

Lista separada por espacios de instancias de VMSS que se van a incluir en la captura de paquetes como 0 1 2. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

Propiedad Valor
Parameter group: Scope Arguments
--no-wait

No espere a que finalice la operación de ejecución prolongada.

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

Nombre o identificador de una cuenta de almacenamiento en la que guardar la captura de paquetes.

Propiedad Valor
Parameter group: Storage Arguments
--storage-path

URI completo de un contenedor de almacenamiento existente en el que almacenar el archivo de captura. Si no se especifica, el contenedor network-watcher-logs se creará si no existe y el archivo de captura se almacenará allí.

Propiedad Valor
Parameter group: Storage Arguments
--target

Nombre o identificador del recurso de destino. Si --target-type es AzureVMSS, --target es obligatorio.

--target-type

Tipo de recurso de destino.

Propiedad Valor
Valor predeterminado: AzureVM
Valores aceptados: AzureVM, AzureVMSS
--time-limit

Duración máxima de la sesión de captura en segundos.

Propiedad Valor
Valor predeterminado: 18000
--vm

Nombre o identificador de la máquina virtual de destino.

Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az network watcher packet-capture delete

Elimine una sesión de captura de paquetes.

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

Ejemplos

Elimine una sesión de captura de paquetes. Esto solo elimina la sesión y no el archivo de captura.

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

Parámetros requeridos

--location -l

Location. Los valores de: az account list-locations. Puede configurar la ubicación predeterminada mediante az configure --defaults location=<location>.

--name -n

Nombre de la sesión de captura de paquetes.

Parámetros opcionales

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--no-wait

No espere a que finalice la operación de ejecución prolongada.

Propiedad Valor
Valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az network watcher packet-capture list

Enumere todas las sesiones de captura de paquetes dentro de una región.

az network watcher packet-capture list --location

Ejemplos

Enumere todas las sesiones de captura de paquetes dentro de una región.

az az network watcher packet-capture list -l westus

Parámetros requeridos

--location -l

Location. Los valores de: az account list-locations. Puede configurar la ubicación predeterminada mediante az configure --defaults location=<location>.

Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az network watcher packet-capture show

Mostrar detalles de una sesión de captura de paquetes.

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

Ejemplos

Mostrar una sesión de captura de paquetes.

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

Parámetros requeridos

--location -l

Location. Los valores de: az account list-locations. Puede configurar la ubicación predeterminada mediante az configure --defaults location=<location>.

--name -n

Nombre de la sesión de captura de paquetes.

Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az network watcher packet-capture show-status

Muestra el estado de una sesión de captura de paquetes.

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

Ejemplos

Muestra el estado de una sesión de captura de paquetes.

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

Parámetros requeridos

--location -l

Location. Los valores de: az account list-locations. Puede configurar la ubicación predeterminada mediante az configure --defaults location=<location>.

--name -n

Nombre asignado a la sesión de captura de paquetes.

Parámetros opcionales

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--no-wait

No espere a que finalice la operación de ejecución prolongada.

Propiedad Valor
Valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az network watcher packet-capture stop

Detenga una sesión de captura de paquetes en ejecución.

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

Ejemplos

Detenga una sesión de captura de paquetes en ejecución.

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

Parámetros requeridos

--location -l

Location. Los valores de: az account list-locations. Puede configurar la ubicación predeterminada mediante az configure --defaults location=<location>.

--name -n

Nombre de la sesión de captura de paquetes.

Parámetros opcionales

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--no-wait

No espere a que finalice la operación de ejecución prolongada.

Propiedad Valor
Valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az network watcher packet-capture wait

Coloque la CLI en un estado de espera hasta que se cumpla una condición.

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

Parámetros opcionales

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--created

Espere hasta que se cree con "provisioningState" en "Succeeded".

Propiedad Valor
Parameter group: Wait Condition Arguments
Valor predeterminado: False
--custom

Espere hasta que la condición cumpla una consulta JMESPath personalizada. Por ejemplo, provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

Propiedad Valor
Parameter group: Wait Condition Arguments
--deleted

Espere hasta que se elimine.

Propiedad Valor
Parameter group: Wait Condition Arguments
Valor predeterminado: False
--exists

Espere hasta que exista el recurso.

Propiedad Valor
Parameter group: Wait Condition Arguments
Valor predeterminado: False
--ids

Uno o varios identificadores de recursos (delimitados por espacio). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

Propiedad Valor
Parameter group: Resource Id Arguments
--interval

Intervalo de sondeo en segundos.

Propiedad Valor
Parameter group: Wait Condition Arguments
Valor predeterminado: 30
--name -n

Nombre de la sesión de captura de paquetes.

Propiedad Valor
Parameter group: Resource Id Arguments
--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

Propiedad Valor
Parameter group: Resource Id Arguments
--timeout

Espera máxima en segundos.

Propiedad Valor
Parameter group: Wait Condition Arguments
Valor predeterminado: 3600
--updated

Espere hasta que se actualice con provisioningState en "Succeeded".

Propiedad Valor
Parameter group: Wait Condition Arguments
Valor predeterminado: False
--watcher-name

Nombre del monitor de red.

Propiedad Valor
Parameter group: Resource Id Arguments
--watcher-rg

Nombre del grupo de recursos en el que está el monitor.

Propiedad Valor
Parameter group: Resource Id Arguments
Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False