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 Pacote. O cmdlet New-AzPacketCaptureScopeConfig pode aceitar várias sessões de captura de instâncias VMSS habilitar/desabilitar sessões de captura composable.

Exemplos

Exemplo 1: criar uma captura de pacote 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 no Escopo de Inclusão e um limite de tempo. Depois que a sessão for concluída, ela será salva na conta de armazenamento especificada. Observação: a extensão do Observador de Rede do Azure deve ser instalada na máquina virtual de destino para criar capturas de pacotes.

Exemplo 2: criar uma captura de pacote com várias instâncias do VMSS no escopo de exclusã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 -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 no Escopo de Exclusão, o que significa que, além dessas instâncias fornecidas, a Captura de Pacotes estaria funcionando em todas as outras instâncias e um limite de tempo. Depois que a sessão for concluída, ela será salva na conta de armazenamento especificada. Observação: a extensão do Observador 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 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

Computadores a serem excluídos no escopo

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

-Include

Computadores a serem incluídos 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