Condividi tramite

az network watcher packet-capture

  • Riferimento

Gestire le sessioni di acquisizione pacchetti nelle macchine virtuali.

Questi comandi richiedono che sia Azure Network Watcher sia abilitato per l'area delle macchine virtuali e che AzureNetworkWatcherExtension sia abilitato nella macchina virtuale. Per altre informazioni, vedere https://learn.microsoft.com/en-us/azure/network-watcher/network-watcher-packet-capture-manage-cli.

Comandi

Nome Descrizione Tipo Status
az network watcher packet-capture create

Creare e avviare una sessione di acquisizione pacchetti.

 Memoria centrale Disponibilità generale
az network watcher packet-capture delete

Eliminare una sessione di acquisizione pacchetti.

 Memoria centrale Disponibilità generale
az network watcher packet-capture list

Elencare tutte le sessioni di acquisizione pacchetti all'interno di un'area.

 Memoria centrale Disponibilità generale
az network watcher packet-capture show

Mostra i dettagli di una sessione di acquisizione pacchetti.

 Memoria centrale Disponibilità generale
az network watcher packet-capture show-status

Visualizzare lo stato di una sessione di acquisizione pacchetti.

 Memoria centrale Disponibilità generale
az network watcher packet-capture stop

Arrestare una sessione di acquisizione pacchetti in esecuzione.

 Memoria centrale Disponibilità generale
az network watcher packet-capture wait

Posizionare l'interfaccia della riga di comando in uno stato di attesa fino a quando non viene soddisfatta una condizione.

 Memoria centrale Disponibilità generale

az network watcher packet-capture create

Modifica

Creare e avviare una sessione di acquisizione pacchetti.

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]

Esempio

Creare una sessione di acquisizione pacchetti in una macchina virtuale.

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

Creare una sessione di acquisizione di pacchetti in una macchina virtuale con filtri facoltativi per protocolli, indirizzi IP locali e intervalli di indirizzi IP remoti e porte.

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

Creare una sessione di acquisizione di pacchetti in un set di scalabilità di macchine virtuali.

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

Creare una sessione di acquisizione di pacchetti in un set di scalabilità di macchine virtuali con istanze specifiche.

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

Creare una sessione di acquisizione di pacchetti in un set di scalabilità di macchine virtuali con l'esclusione di istanze specifiche.

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

Parametri necessari

--name -n

Nome della sessione di acquisizione pacchetti.

--resource-group -g

Nome del gruppo di risorse in cui si trova la risorsa di destinazione.

Parametri facoltativi

--capture-limit

Dimensione massima in byte dell'output di acquisizione.

Valore predefinito: 1073741824
--capture-size

Numero di byte acquisiti per pacchetto. I byte in eccesso vengono troncati.

Valore predefinito: 0
--exclude

Elenco separato da spazi di istanze del set di scalabilità di macchine virtuali da escludere nell'acquisizione di pacchetti. Supportare la sintassi abbreviata, json-file e yaml-file. Prova "??" per mostrare di più.

--file-path

Percorso locale nella macchina virtuale di destinazione in cui salvare l'acquisizione di pacchetti. Per le macchine virtuali Linux, il percorso deve iniziare con /var/captures.

--filters

Elenco con codifica JSON dei filtri di pacchetti. Usare @{path} per caricare dal file. Supportare la sintassi abbreviata, json-file e yaml-file. Prova "??" per mostrare di più.

--include

Elenco separato da spazi delle istanze del set di scalabilità di macchine virtuali da includere nell'acquisizione di pacchetti, ad esempio 0 1 2. Supportare la sintassi abbreviata, json-file e yaml-file. Prova "??" per mostrare di più.

--no-wait

Indica che non è necessario attendere il termine dell'operazione a esecuzione prolungata.

Valori accettati: 0, 1, f, false, n, no, t, true, y, yes
--storage-account

Nome o ID di un account di archiviazione in cui salvare l'acquisizione di pacchetti.

--storage-path

URI completo di un contenitore di archiviazione esistente in cui archiviare il file di acquisizione. Se non specificato, il contenitore network-watcher-logs verrà creato se non esiste e il file di acquisizione verrà archiviato in tale posizione.

--target

Nome o ID della risorsa di destinazione. Se --target-type è AzureVMSS, --target è obbligatorio.

--target-type

Tipo di risorsa di destinazione.

Valori accettati: AzureVM, AzureVMSS
Valore predefinito: AzureVM
--time-limit

Durata massima della sessione di acquisizione in secondi.

Valore predefinito: 18000
--vm

Nome o ID della macchina virtuale di destinazione.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az network watcher packet-capture delete

Modifica

Eliminare una sessione di acquisizione pacchetti.

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

Esempio

Eliminare una sessione di acquisizione pacchetti. In questo modo viene eliminata solo la sessione e non il file di acquisizione.

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

Parametri necessari

--location -l

Posizione. Usare i valori ottenuti con az account list-locations. È possibile configurare la posizione predefinito con az configure --defaults location=<location>.

--name -n

Nome della sessione di acquisizione pacchetti.

Parametri facoltativi

--no-wait

Indica che non è necessario attendere il termine dell'operazione a esecuzione prolungata.

Valori accettati: 0, 1, f, false, n, no, t, true, y, yes
Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az network watcher packet-capture list

Modifica

Elencare tutte le sessioni di acquisizione pacchetti all'interno di un'area.

az network watcher packet-capture list --location

Esempio

Elencare tutte le sessioni di acquisizione pacchetti all'interno di un'area.

az az network watcher packet-capture list -l westus

Parametri necessari

--location -l

Posizione. Usare i valori ottenuti con az account list-locations. È possibile configurare la posizione predefinito con az configure --defaults location=<location>.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az network watcher packet-capture show

Modifica

Mostra i dettagli di una sessione di acquisizione pacchetti.

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

Esempio

Visualizzare una sessione di acquisizione pacchetti.

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

Parametri necessari

--location -l

Posizione. Usare i valori ottenuti con az account list-locations. È possibile configurare la posizione predefinito con az configure --defaults location=<location>.

--name -n

Nome della sessione di acquisizione pacchetti.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az network watcher packet-capture show-status

Modifica

Visualizzare lo stato di una sessione di acquisizione pacchetti.

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

Esempio

Visualizzare lo stato di una sessione di acquisizione pacchetti.

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

Parametri necessari

--location -l

Posizione. Usare i valori ottenuti con az account list-locations. È possibile configurare la posizione predefinito con az configure --defaults location=<location>.

--name -n

Nome assegnato alla sessione di acquisizione pacchetti.

Parametri facoltativi

--no-wait

Indica che non è necessario attendere il termine dell'operazione a esecuzione prolungata.

Valori accettati: 0, 1, f, false, n, no, t, true, y, yes
Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az network watcher packet-capture stop

Modifica

Arrestare una sessione di acquisizione pacchetti in esecuzione.

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

Esempio

Arrestare una sessione di acquisizione pacchetti in esecuzione.

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

Parametri necessari

--location -l

Posizione. Usare i valori ottenuti con az account list-locations. È possibile configurare la posizione predefinito con az configure --defaults location=<location>.

--name -n

Nome della sessione di acquisizione pacchetti.

Parametri facoltativi

--no-wait

Indica che non è necessario attendere il termine dell'operazione a esecuzione prolungata.

Valori accettati: 0, 1, f, false, n, no, t, true, y, yes
Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az network watcher packet-capture wait

Modifica

Posizionare l'interfaccia della riga di comando in uno stato di attesa fino a quando non viene soddisfatta una condizione.

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

Parametri facoltativi

--created

Attendere fino a quando non viene creato con 'provisioningState' in 'Succeeded'.

Valore predefinito: False
--custom

Attendere che la condizione soddisfi una query JMESPath personalizzata. Ad esempio provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Attendere l'eliminazione.

Valore predefinito: False
--exists

Attendere che la risorsa esista.

Valore predefinito: False
--ids

Uno o più ID della risorsa (delimitato da spazio). Deve essere un ID risorsa completo contenente tutte le informazioni degli argomenti "ID risorsa". È necessario specificare --ids o altri argomenti "ID risorsa".

--interval

Intervallo di polling in secondi.

Valore predefinito: 30
--name -n

Nome della sessione di acquisizione pacchetti.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--timeout

Attesa massima in secondi.

Valore predefinito: 3600
--updated

Attendere fino a quando non viene aggiornato con provisioningState in 'Succeeded'.

Valore predefinito: False
--watcher-name

Nome del network watcher.

--watcher-rg

Nome del gruppo di risorse in cui si trova il watcher.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.