Freigeben über


New-AzPacketCaptureScopeConfig

Erstellt ein neues Paketaufnahmebereichsobjekt.

Syntax

New-AzPacketCaptureScopeConfig
   [-Include <String[]>]
   [-Exclude <String[]>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Beschreibung

Mit dem Cmdlet New-AzPacketCaptureScopeConfig wird ein neues Paketerfassungsbereichsobjekt erstellt. Dieses Objekt wird verwendet, um die bereitgestellten VMSS-Instanzen zum Ausführen von Paketerfassungen einzuschließen oder auszuschließen. Das Cmdlet New-AzPacketCaptureScopeConfig kann mehrere VMSS-Instanzennamen akzeptieren, um aufzeichnungsfähige Sitzungen zu aktivieren/zu deaktivieren.

Beispiele

Beispiel 1: Erstellen einer Paketaufnahme mit mehreren VMSS-Instanzen im Include-Bereich

$nw = Get-AzResource | Where {$_.ResourceType -eq "Microsoft.Network/networkWatchers" -and $_.Location -eq "WestCentralUS" } 
$networkWatcher = Get-AzNetworkWatcher -Name $nw.Name -ResourceGroupName $nw.ResourceGroupName 

$storageAccount = Get-AzStorageAccount -ResourceGroupName contosoResourceGroup -Name contosostorage123

$instance1 = $vmssInstance1.Name
$instance2 = $vmssInstance2.Name
$scope = New-AzPacketCaptureScopeConfig -Include $instance1, $instance2

New-AzNetworkWatcherPacketCaptureV2 -NetworkWatcher $networkWatcher -TargetId $vmss.Id -TargetType "azurevmss" -Scope $scope -PacketCaptureName "PacketCaptureTest" -StorageAccountId $storageAccount.id -TimeLimitInSecond 60

In diesem Beispiel erstellen wir eine Paketerfassung namens "PacketCaptureTest" mit mehreren VMSS-Instanzen in Include Scope und einem Zeitlimit. Sobald die Sitzung abgeschlossen ist, wird sie im angegebenen Speicherkonto gespeichert. Hinweis: Die Azure Network Watcher-Erweiterung muss auf dem virtuellen Zielcomputer installiert sein, um Paketerfassungen zu erstellen.

Beispiel 2: Erstellen einer Paketerfassung mit mehreren VMSS-Instanzen im Ausschlussbereich

$nw = Get-AzResource | Where {$_.ResourceType -eq "Microsoft.Network/networkWatchers" -and $_.Location -eq "WestCentralUS" } 
$networkWatcher = Get-AzNetworkWatcher -Name $nw.Name -ResourceGroupName $nw.ResourceGroupName 

$storageAccount = Get-AzStorageAccount -ResourceGroupName contosoResourceGroup -Name contosostorage123

$instance1 = $vmssInstance1.Name
$instance2 = $vmssInstance2.Name
$scope = New-AzPacketCaptureScopeConfig -Exclude $instance1, $instance2

New-AzNetworkWatcherPacketCaptureV2 -NetworkWatcher $networkWatcher -TargetId $vmss.Id -TargetType "azurevmss" -Scope $scope -PacketCaptureName "PacketCaptureTest" -StorageAccountId $storageAccount.id -TimeLimitInSecond 60

In diesem Beispiel wird eine Paketerfassung namens "PacketCaptureTest" mit mehreren VMSS-Instanzen im Exclude-Bereich erstellt, was bedeutet, dass die Paketerfassung abgesehen von dieser bereitgestellten Instanz an allen anderen Instanzen und einem Zeitlimit funktioniert. Sobald die Sitzung abgeschlossen ist, wird sie im angegebenen Speicherkonto gespeichert. Hinweis: Die Azure Network Watcher-Erweiterung muss auf dem virtuellen Zielcomputer installiert sein, um Paketerfassungen zu erstellen.

Parameter

-DefaultProfile

Die Anmeldeinformationen, Konten, Mandanten und Abonnements, die für die Kommunikation mit Azure verwendet werden.

Typ:IAzureContextContainer
Aliase:AzContext, AzureRmContext, AzureCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Exclude

Computer, die im Bereich ausgeschlossen werden sollen

Typ:String[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Include

Computer, die im Bereich enthalten sein sollen

Typ:String[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

Eingaben

String[]

Ausgaben

PSPacketCaptureMachineScope