New-AzPacketCaptureFilterConfig

  • Referencia
Módulo:
Az.Network

Crea un nuevo objeto de filtro de captura de paquetes.

Syntax

New-AzPacketCaptureFilterConfig
   [-Protocol <String>]
   [-RemoteIPAddress <String>]
   [-LocalIPAddress <String>]
   [-LocalPort <String>]
   [-RemotePort <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

El cmdlet New-AzPacketCaptureFilterConfig crea un nuevo objeto de filtro de captura de paquetes. Este objeto se usa para restringir el tipo de paquetes que se capturan durante una sesión de captura de paquetes mediante los criterios especificados. El cmdlet New-AzNetworkWatcherPacketCapture puede aceptar varios objetos de filtro para habilitar sesiones de captura compuestas.

Ejemplos

Ejemplo 1: Crear una captura de paquetes con varios filtros

$nw = Get-AzResource | Where-Object {$_.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

$filter1 = New-AzPacketCaptureFilterConfig -Protocol TCP -RemoteIPAddress "1.1.1.1-255.255.255" -LocalIPAddress "10.0.0.3" -LocalPort "1-65535" -RemotePort "20;80;443"
$filter2 = New-AzPacketCaptureFilterConfig -Protocol UDP 
New-AzNetworkWatcherPacketCapture -NetworkWatcher $networkWatcher -TargetVirtualMachineId $vm.Id -PacketCaptureName "PacketCaptureTest" -StorageAccountId $storageAccount.id -TimeLimitInSeconds 60 -Filter $filter1, $filter2

En este ejemplo se crea una captura de paquetes denominada "PacketCaptureTest" con varios filtros y un límite de tiempo. Una vez completada la sesión, se guardará en la cuenta de almacenamiento especificada. Nota: La extensión de Azure Network Watcher debe instalarse en la máquina virtual de destino para crear capturas de paquetes.

Parámetros

-DefaultProfile

Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación con Azure.

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

-LocalIPAddress

Especifica la dirección IP local en la que se va a filtrar. Entradas de ejemplo: "127.0.0.1" para la entrada de dirección única. "127.0.0.1-127.0.0.255" para el rango. "127.0.0.1; 127.0.0.5;" para varias entradas.

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

-LocalPort

Especifica la dirección IP local en la que se va a filtrar. Entradas de ejemplo: "127.0.0.1" para la entrada de dirección única. "127.0.0.1-127.0.0.255" para el rango. "127.0.0.1; 127.0.0.5;" para varias entradas.

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

-Protocol

Especifica el protocolo en el que se va a filtrar. Valores aceptables "TCP","UDP", "Any"

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

-RemoteIPAddress

Especifica la dirección IP remota en la que se va a filtrar. Entradas de ejemplo: "127.0.0.1" para la entrada de dirección única. "127.0.0.1-127.0.0.255" para el rango. "127.0.0.1; 127.0.0.5;" para varias entradas.

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

-RemotePort

Especifica el puerto remoto en el que se va a filtrar. Entradas de ejemplo de puerto remoto: "80" para la entrada de puerto único. "80-85" para el intervalo. "80; 443;" para varias entradas.

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

Entradas

String

Salidas

PSPacketCaptureFilter

Notas

Palabras clave: azure, azurerm, arm, resource, management, manager, network, networking, watcher, packet, capture, traffic, filter