Compartir a través de

New-AzPacketCaptureFilterConfig

Módulo:
Az.Network Module

Crea un nuevo objeto de filtro de captura de paquetes.

Sintaxis

Default (valor predeterminado) 

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.

Propiedades de parámetro

Tipo:IAzureContextContainer
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes: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.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes: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.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-Protocol

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

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes: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.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes: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.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

Entradas

String

Salidas

PSPacketCaptureFilter

Notas

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