Compartilhar via


New-AzPacketCaptureScopeConfig

Cria um novo objeto de escopo de captura de pacote.

Sintaxe

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

Description

O cmdlet New-AzPacketCaptureScopeConfig cria um novo objeto de escopo de captura de pacote. Esse objeto é usado para incluir ou excluir as instâncias VMSS fornecidas para executar capturas de pacotes. O cmdlet New-AzPacketCaptureScopeConfig pode aceitar vários nomes de instâncias do VMSS habilitar/desabilitar sessões de captura componíveis.

Exemplos

Exemplo 1: Criar uma captura de pacotes com várias instâncias do VMSS no escopo de inclusão

$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

Neste exemplo, criamos uma captura de pacote chamada "PacketCaptureTest" com várias instâncias VMSS em Incluir escopo e um limite de tempo. Quando a sessão estiver concluída, ela será salva na conta de armazenamento especificada. Observação: a extensão do Inspetor de Rede do Azure deve ser instalada na máquina virtual de destino para criar capturas de pacotes.

Exemplo 2: Criar uma captura de pacotes com várias instâncias do VMSS em Excluir escopo

$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

Neste exemplo, criamos uma captura de pacote chamada "PacketCaptureTest" com várias instâncias VMSS em Excluir escopo - o que significa que, além dessas instâncias fornecidas, a captura de pacotes estaria funcionando em todas as outras instâncias e em um limite de tempo. Quando a sessão estiver concluída, ela será salva na conta de armazenamento especificada. Observação: a extensão do Inspetor de Rede do Azure deve ser instalada na máquina virtual de destino para criar capturas de pacotes.

Parâmetros

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para a comunicação com o Azure.

Tipo:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Exclude

Máquinas a serem excluídas do escopo

Tipo:String[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Include

Máquinas a serem incluídas no escopo

Tipo:String[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

Entradas

String[]

Saídas

PSPacketCaptureMachineScope