Share via

New-AzPacketCaptureScopeConfig

  • Référence
Module:
Az.Network

Crée un objet d’étendue de capture de paquets.

Syntax

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

Description

L’applet de commande New-AzPacketCaptureScopeConfig crée un objet d’étendue de capture de paquets. Cet objet est utilisé pour inclure ou exclure les instances VMSS fournies pour l’exécution de captures de paquets. L’applet de commande New-AzPacketCaptureScopeConfig peut accepter plusieurs noms d’instances VMSS activer/désactiver les sessions de capture composables.

Exemples

Exemple 1 : Créer une capture de paquets avec plusieurs instances VMSS dans l’étendue Include

$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

Dans cet exemple, nous créons une capture de paquets nommée « PacketCaptureTest » avec plusieurs instances VMSS dans Include Scope et une limite de temps. Une fois la session terminée, elle est enregistrée dans le compte de stockage spécifié. Remarque : L’extension Azure Network Watcher doit être installée sur la machine virtuelle cible pour créer des captures de paquets.

Exemple 2 : Créer une capture de paquets avec plusieurs instances VMSS dans l’étendue d’exclusion

$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

Dans cet exemple, nous créons une capture de paquets nommée « PacketCaptureTest » avec plusieurs instances VMSS dans l’étendue d’exclusion, ce qui signifie qu’en dehors de ces instances fournies, la capture de paquets fonctionne sur toutes les autres instances et une limite de temps. Une fois la session terminée, elle est enregistrée dans le compte de stockage spécifié. Remarque : L’extension Azure Network Watcher doit être installée sur la machine virtuelle cible pour créer des captures de paquets.

Paramètres

-DefaultProfile

Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure.

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Exclude

Machines à exclure dans l’étendue

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Include

Machines à inclure dans l’étendue

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

Entrées

String[]

Sorties

PSPacketCaptureMachineScope