Compartir vía

az network watcher packet-capture

  • Referencia

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.

 Principal GA
az network watcher packet-capture delete

Elimine una sesión de captura de paquetes.

 Principal GA
az network watcher packet-capture list

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

 Principal GA
az network watcher packet-capture show

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

 Principal GA
az network watcher packet-capture show-status

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

 Principal GA
az network watcher packet-capture stop

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

 Principal GA
az network watcher packet-capture wait

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

 Principal GA

az network watcher packet-capture create

Editar

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

--capture-limit

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

Valor predeterminado: 1073741824
--capture-size

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

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.

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

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

--no-wait

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

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.

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

--target

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

--target-type

Tipo de recurso de destino.

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

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

Valor predeterminado: 18000
--vm

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

Parámetros globales
--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

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

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--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 de registro. Use --debug para obtener registros de depuración completos.

az network watcher packet-capture delete

Editar

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

--no-wait

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

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

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

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

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--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 de registro. Use --debug para obtener registros de depuración completos.

az network watcher packet-capture list

Editar

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 de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

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

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--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 de registro. Use --debug para obtener registros de depuración completos.

az network watcher packet-capture show

Editar

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 de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

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

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--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 de registro. Use --debug para obtener registros de depuración completos.

az network watcher packet-capture show-status

Editar

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

--no-wait

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

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

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

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

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--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 de registro. Use --debug para obtener registros de depuración completos.

az network watcher packet-capture stop

Editar

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

--no-wait

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

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

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

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

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--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 de registro. Use --debug para obtener registros de depuración completos.

az network watcher packet-capture wait

Editar

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

--created

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

Valor predeterminado: False
--custom

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

--deleted

Espere hasta que se elimine.

Valor predeterminado: False
--exists

Espere hasta que exista el recurso.

Valor predeterminado: False
--ids

Uno o varios identificadores de recursos (delimitados por espacios). 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".

--interval

Intervalo de sondeo en segundos.

Valor predeterminado: 30
--name -n

Nombre de la sesión de captura de paquetes.

--subscription

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

--timeout

Espera máxima en segundos.

Valor predeterminado: 3600
--updated

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

Valor predeterminado: False
--watcher-name

Nombre del monitor de red.

--watcher-rg

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

Parámetros globales
--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

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

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--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 de registro. Use --debug para obtener registros de depuración completos.