Compartir a través de

New-AzureRmPacketCaptureFilterConfig

  • Referencia
Módulo:
AzureRM.Network

Crea un nuevo objeto de filtro de captura de paquetes.

Advertencia

El módulo de PowerShell de AzureRM ha quedado en desuso oficialmente a partir del 29 de febrero de 2024. Se recomienda a los usuarios migrar de AzureRM al módulo Az PowerShell para seguir recibiendo soporte técnico y actualizaciones.

Aunque el módulo AzureRM puede seguir funcionando, ya no se mantiene ni se admite, colocando cualquier uso continuado a discreción y riesgo del usuario. Consulte nuestros recursos de migración para ver una guía sobre la transición al módulo Az.

Syntax

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

Description

El cmdlet New-AzureRmPacketCaptureFilterConfig 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-AzureRmNetworkWatcherPacketCapture 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-AzurermResource | Where {$_.ResourceType -eq "Microsoft.Network/networkWatchers" -and $_.Location -eq "WestCentralUS" } 
$networkWatcher = Get-AzureRmNetworkWatcher -Name $nw.Name -ResourceGroupName $nw.ResourceGroupName 

$storageAccount = Get-AzureRmStorageAccount -ResourceGroupName contosoResourceGroup -Name contosostorage123

$filter1 = New-AzureRmPacketCaptureFilterConfig -Protocol TCP -RemoteIPAddress "1.1.1.1-255.255.255" -LocalIPAddress "10.0.0.3" -LocalPort "1-65535" -RemotePort "20;80;443"
$filter2 = New-AzureRmPacketCaptureFilterConfig -Protocol UDP 
New-AzureRmNetworkWatcherPacketCapture -NetworkWatcher $networkWatcher -TargetVirtualMachineId $vm.Id -PacketCaptureName "PacketCaptureTest" -StorageAccountId $storageAccount.id -TimeLimitInSeconds 60 -Filters $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.

Tipo:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
valor predeterminado:None
Requerido: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.

Tipo:String
Position:Named
valor predeterminado:None
Requerido: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.

Tipo:String
Position:Named
valor predeterminado:None
Requerido:False
Accept pipeline input:True
Accept wildcard characters:False

-Protocol

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

Tipo:String
Position:Named
valor predeterminado:None
Requerido: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.

Tipo:String
Position:Named
valor predeterminado:None
Requerido: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.

Tipo:String
Position:Named
valor predeterminado:None
Requerido:False
Accept pipeline input:True
Accept wildcard characters:False

Entradas

String

Parámetros: Protocolo (ByValue)

Salidas

PSPacketCaptureFilter

Notas

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