Compartilhar via


New-AzPacketCaptureScopeConfig

Cria um novo objeto de escopo de captura de pacote.

Sintaxe

Default (Default)

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 a comunicação com o Azure.

Propriedades do parâmetro

Tipo:IAzureContextContainer
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:AzContext, AzureRmContext, AzureCredential

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Exclude

Computadores a serem excluídos no escopo

Propriedades do parâmetro

Tipo:

String[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-Include

Computadores a serem incluídos no escopo

Propriedades do parâmetro

Tipo:

String[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Entradas

String

Saídas

PSPacketCaptureMachineScope