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
Nombre de la sesión de captura de paquetes.
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.
Tamaño máximo en bytes de la salida de captura.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | 1073741824 |
Número de bytes capturados por paquete. Se truncan los bytes excesivos.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | 0 |
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 |
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 |
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.
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 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 |
Nombre o identificador de una cuenta de almacenamiento en la que guardar la captura de paquetes.
| Propiedad | Valor |
|---|---|
| Parameter group: | Storage Arguments |
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 |
Nombre o identificador del recurso de destino. Si --target-type es AzureVMSS, --target es obligatorio.
Tipo de recurso de destino.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | AzureVM |
| Valores aceptados: | AzureVM, AzureVMSS |
Duración máxima de la sesión de captura en segundos.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | 18000 |
Nombre o identificador de la máquina virtual de destino.
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, suprimiendo advertencias.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Formato de salida.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | json |
| Valores aceptados: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.
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. Los valores de: az account list-locations. Puede configurar la ubicación predeterminada mediante az configure --defaults location=<location>.
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 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
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, suprimiendo advertencias.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Formato de salida.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | json |
| Valores aceptados: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.
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. Los valores de: az account list-locations. Puede configurar la ubicación predeterminada mediante az configure --defaults location=<location>.
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, suprimiendo advertencias.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Formato de salida.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | json |
| Valores aceptados: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.
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. Los valores de: az account list-locations. Puede configurar la ubicación predeterminada mediante az configure --defaults location=<location>.
Nombre de la sesión de captura de paquetes.
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, suprimiendo advertencias.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Formato de salida.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | json |
| Valores aceptados: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.
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. Los valores de: az account list-locations. Puede configurar la ubicación predeterminada mediante az configure --defaults location=<location>.
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 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
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, suprimiendo advertencias.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Formato de salida.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | json |
| Valores aceptados: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.
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. Los valores de: az account list-locations. Puede configurar la ubicación predeterminada mediante az configure --defaults location=<location>.
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 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
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, suprimiendo advertencias.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Formato de salida.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | json |
| Valores aceptados: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.
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.
Espere hasta que se cree con "provisioningState" en "Succeeded".
| Propiedad | Valor |
|---|---|
| Parameter group: | Wait Condition Arguments |
| Valor predeterminado: | False |
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 |
Espere hasta que se elimine.
| Propiedad | Valor |
|---|---|
| Parameter group: | Wait Condition Arguments |
| Valor predeterminado: | False |
Espere hasta que exista el recurso.
| Propiedad | Valor |
|---|---|
| Parameter group: | Wait Condition Arguments |
| Valor predeterminado: | False |
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 |
Intervalo de sondeo en segundos.
| Propiedad | Valor |
|---|---|
| Parameter group: | Wait Condition Arguments |
| Valor predeterminado: | 30 |
Nombre de la sesión de captura de paquetes.
| Propiedad | Valor |
|---|---|
| Parameter group: | Resource Id Arguments |
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 |
Espera máxima en segundos.
| Propiedad | Valor |
|---|---|
| Parameter group: | Wait Condition Arguments |
| Valor predeterminado: | 3600 |
Espere hasta que se actualice con provisioningState en "Succeeded".
| Propiedad | Valor |
|---|---|
| Parameter group: | Wait Condition Arguments |
| Valor predeterminado: | False |
Nombre del monitor de red.
| Propiedad | Valor |
|---|---|
| Parameter group: | Resource Id Arguments |
Nombre del grupo de recursos en el que está el monitor.
| Propiedad | Valor |
|---|---|
| Parameter group: | Resource Id Arguments |
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, suprimiendo advertencias.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Formato de salida.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | json |
| Valores aceptados: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |