Delen via

az network watcher packet-capture

  • Referentie

Beheer pakketopnamesessies op VM's.

Voor deze opdrachten is vereist dat zowel Azure Network Watcher is ingeschakeld voor de vm-regio en dat AzureNetworkWatcherExtension is ingeschakeld op de VIRTUELE machine. Ga voor meer informatie naar https://learn.microsoft.com/en-us/azure/network-watcher/network-watcher-packet-capture-manage-cli.

Opdracht

Name Description Type Status
az network watcher packet-capture create

Maak en start een pakketopnamesessie.

 Basis GA
az network watcher packet-capture delete

Een pakketopnamesessie verwijderen.

 Basis GA
az network watcher packet-capture list

Vermeld alle pakketopnamesessies binnen een regio.

 Basis GA
az network watcher packet-capture show

Details van een pakketopnamesessie weergeven.

 Basis GA
az network watcher packet-capture show-status

De status van een pakketopnamesessie weergeven.

 Basis GA
az network watcher packet-capture stop

Stop een actieve pakketopnamesessie.

 Basis GA
az network watcher packet-capture wait

Plaats de CLI in een wachtstatus totdat aan een voorwaarde is voldaan.

 Basis GA

az network watcher packet-capture create

Bewerken

Maak en start een pakketopnamesessie.

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]

Voorbeelden

Maak een pakketopnamesessie op een VIRTUELE machine.

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

Maak een pakketopnamesessie op een VIRTUELE machine met optionele filters voor protocollen, lokaal IP-adres en externe IP-adresbereiken en poorten.

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

Maak een pakketopnamesessie op een VMSS.

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

Maak een pakketopnamesessie op een VMSS met inbegrip van bepaalde exemplaren.

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

Maak een pakketopnamesessie op een VMSS met uitzondering van bepaalde exemplaren.

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

Vereiste parameters

--name -n

Naam van de pakketopnamesessie.

--resource-group -g

De naam van de resourcegroep waarin de doelresource zich bevindt.

Optionele parameters

--capture-limit

Maximale grootte in bytes van de uitvoer van de opname.

Default value: 1073741824
--capture-size

Aantal bytes dat per pakket is vastgelegd. Overtollige bytes worden afgekapt.

Default value: 0
--exclude

Door ruimte gescheiden lijst met VMSS-exemplaren die moeten worden uitgesloten in pakketopname. Ondersteuning voor shorthand-syntaxis, json-file en yaml-file. Probeer '??' om meer weer te geven.

--file-path

Lokaal pad op de doel-VM waarop de pakketopname moet worden opgeslagen. Voor Virtuele Linux-machines moet het pad beginnen met /var/captures.

--filters

Met JSON gecodeerde lijst met pakketfilters. Gebruik @{path} dit bestand om te laden. Ondersteuning voor shorthand-syntaxis, json-file en yaml-file. Probeer '??' om meer weer te geven.

--include

Door ruimte gescheiden lijst met VMSS-exemplaren die moeten worden opgenomen in pakketopname, zoals 0 1 2. Ondersteuning voor shorthand-syntaxis, json-file en yaml-file. Probeer '??' om meer weer te geven.

--no-wait

Wacht niet totdat de langdurige bewerking is voltooid.

Geaccepteerde waarden: 0, 1, f, false, n, no, t, true, y, yes
--storage-account

Naam of id van een opslagaccount om de pakketopname op te slaan.

--storage-path

Volledig gekwalificeerde URI van een bestaande opslagcontainer waarin het capture-bestand moet worden opgeslagen. Als deze niet is opgegeven, wordt de container network-watcher-logs gemaakt als deze niet bestaat en wordt het opnamebestand daar opgeslagen.

--target

Naam of id van de doelresource. Als --target-type AzureVMSS is, is dit --target verplicht.

--target-type

Resourcetype van doel.

Geaccepteerde waarden: AzureVM, AzureVMSS
Default value: AzureVM
--time-limit

Maximale duur van de opnamesessie in seconden.

Default value: 18000
--vm

Naam of id van de VM die moet worden gericht.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az network watcher packet-capture delete

Bewerken

Een pakketopnamesessie verwijderen.

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

Voorbeelden

Een pakketopnamesessie verwijderen. Hiermee verwijdert u alleen de sessie en niet het capture-bestand.

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

Vereiste parameters

--location -l

Locatie. Waarden van: az account list-locations. U kunt de standaardlocatie configureren met behulp van az configure --defaults location=<location>.

--name -n

Naam van de pakketopnamesessie.

Optionele parameters

--no-wait

Wacht niet totdat de langdurige bewerking is voltooid.

Geaccepteerde waarden: 0, 1, f, false, n, no, t, true, y, yes
Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az network watcher packet-capture list

Bewerken

Vermeld alle pakketopnamesessies binnen een regio.

az network watcher packet-capture list --location

Voorbeelden

Vermeld alle pakketopnamesessies binnen een regio.

az az network watcher packet-capture list -l westus

Vereiste parameters

--location -l

Locatie. Waarden van: az account list-locations. U kunt de standaardlocatie configureren met behulp van az configure --defaults location=<location>.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az network watcher packet-capture show

Bewerken

Details van een pakketopnamesessie weergeven.

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

Voorbeelden

Een pakketopnamesessie weergeven.

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

Vereiste parameters

--location -l

Locatie. Waarden van: az account list-locations. U kunt de standaardlocatie configureren met behulp van az configure --defaults location=<location>.

--name -n

Naam van de pakketopnamesessie.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az network watcher packet-capture show-status

Bewerken

De status van een pakketopnamesessie weergeven.

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

Voorbeelden

De status van een pakketopnamesessie weergeven.

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

Vereiste parameters

--location -l

Locatie. Waarden van: az account list-locations. U kunt de standaardlocatie configureren met behulp van az configure --defaults location=<location>.

--name -n

De naam die wordt gegeven aan de pakketopnamesessie.

Optionele parameters

--no-wait

Wacht niet totdat de langdurige bewerking is voltooid.

Geaccepteerde waarden: 0, 1, f, false, n, no, t, true, y, yes
Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az network watcher packet-capture stop

Bewerken

Stop een actieve pakketopnamesessie.

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

Voorbeelden

Stop een actieve pakketopnamesessie.

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

Vereiste parameters

--location -l

Locatie. Waarden van: az account list-locations. U kunt de standaardlocatie configureren met behulp van az configure --defaults location=<location>.

--name -n

Naam van de pakketopnamesessie.

Optionele parameters

--no-wait

Wacht niet totdat de langdurige bewerking is voltooid.

Geaccepteerde waarden: 0, 1, f, false, n, no, t, true, y, yes
Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az network watcher packet-capture wait

Bewerken

Plaats de CLI in een wachtstatus totdat aan een voorwaarde is voldaan.

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

Optionele parameters

--created

Wacht totdat u 'provisioningState' hebt gemaakt bij 'Succeeded'.

Default value: False
--custom

Wacht tot de voorwaarde voldoet aan een aangepaste JMESPath-query. Bijvoorbeeld provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Wacht totdat deze is verwijderd.

Default value: False
--exists

Wacht tot de resource bestaat.

Default value: False
--ids

Een of meer resource-id's (met spatie gescheiden). Dit moet een volledige resource-id zijn die alle informatie over de argumenten Resource-id bevat. Geef de argumenten --id's of andere resource-id's op.

--interval

Polling-interval in seconden.

Default value: 30
--name -n

Naam van de pakketopnamesessie.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--timeout

Maximale wachttijd in seconden.

Default value: 3600
--updated

Wacht totdat deze is bijgewerkt met provisioningState op 'Succeeded'.

Default value: False
--watcher-name

Naam van de network watcher.

--watcher-rg

De naam van de resourcegroep waarin de watcher zich bevindt.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.