Compartir a través de

New-AzureRmNetworkWatcherPacketCapture

  • Referencia
Módulo:
AzureRM.Network

Crea un nuevo recurso de captura de paquetes e inicia una sesión de captura de paquetes en una máquina virtual.

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-AzureRmNetworkWatcherPacketCapture
   -NetworkWatcher <PSNetworkWatcher>
   -PacketCaptureName <String>
   -TargetVirtualMachineId <String>
   [-StorageAccountId <String>]
   [-StoragePath <String>]
   [-LocalFilePath <String>]
   [-BytesToCapturePerPacket <Int32>]
   [-TotalBytesPerSession <Int32>]
   [-TimeLimitInSeconds <Int32>]
   [-Filter <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSPacketCaptureFilter]>]
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzureRmNetworkWatcherPacketCapture
   -NetworkWatcherName <String>
   -ResourceGroupName <String>
   -PacketCaptureName <String>
   -TargetVirtualMachineId <String>
   [-StorageAccountId <String>]
   [-StoragePath <String>]
   [-LocalFilePath <String>]
   [-BytesToCapturePerPacket <Int32>]
   [-TotalBytesPerSession <Int32>]
   [-TimeLimitInSeconds <Int32>]
   [-Filter <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSPacketCaptureFilter]>]
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzureRmNetworkWatcherPacketCapture
   -Location <String>
   -PacketCaptureName <String>
   -TargetVirtualMachineId <String>
   [-StorageAccountId <String>]
   [-StoragePath <String>]
   [-LocalFilePath <String>]
   [-BytesToCapturePerPacket <Int32>]
   [-TotalBytesPerSession <Int32>]
   [-TimeLimitInSeconds <Int32>]
   [-Filter <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSPacketCaptureFilter]>]
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

El cmdlet New-AzureRmNetworkWatcherPacketCapture crea un nuevo recurso de captura de paquetes e inicia una sesión de captura de paquetes en una máquina virtual. La longitud de las sesiones de captura de paquetes se puede configurar a través de una restricción de tiempo o una restricción de tamaño. La cantidad de datos capturados para cada paquete también se puede configurar. Los filtros se pueden aplicar a una sesión de captura de paquetes determinada, lo que le permite personalizar el tipo de paquetes capturados. Los filtros pueden restringir los paquetes en las direcciones IP y remotas locales y remotas, los puertos y los intervalos de puertos remotos, y el protocolo de nivel de sesión que se va a capturar. Los filtros se pueden componer y se pueden aplicar varios filtros para proporcionarle granularidad de captura.

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 -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

-AsJob

Ejecución del cmdlet en segundo plano

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

-BytesToCapturePerPacket

Bytes que se van a capturar por paquete.

Tipo:Nullable<T>[Int32]
Position:Named
valor predeterminado:None
Requerido:False
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

Tipo:SwitchParameter
Aliases:cf
Position:Named
valor predeterminado:False
Requerido:False
Accept pipeline input:False
Accept wildcard characters:False

-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

-Filter

Filtra la sesión de captura de paquetes.

Tipo:List<T>[PSPacketCaptureFilter]
Position:Named
valor predeterminado:None
Requerido:False
Accept pipeline input:False
Accept wildcard characters:False

-LocalFilePath

Ruta de acceso del archivo local.

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

-Location

Ubicación del monitor de red.

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

-NetworkWatcher

Recurso de Network Watcher.

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

-NetworkWatcherName

Nombre de Network Watcher.

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

-PacketCaptureName

Nombre de captura de paquetes.

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

-ResourceGroupName

Nombre del grupo de recursos de Network Watcher.

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

-StorageAccountId

Identificador de la cuenta de almacenamiento.

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

-StoragePath

Ruta de acceso de almacenamiento.

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

-TargetVirtualMachineId

Identificador de máquina virtual de destino.

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

-TimeLimitInSeconds

Límite de tiempo en segundos.

Tipo:Nullable<T>[Int32]
Position:Named
valor predeterminado:None
Requerido:False
Accept pipeline input:True
Accept wildcard characters:False

-TotalBytesPerSession

Total de bytes por sesión.

Tipo:Nullable<T>[Int32]
Position:Named
valor predeterminado:None
Requerido:False
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.

Tipo:SwitchParameter
Aliases:wi
Position:Named
valor predeterminado:False
Requerido:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

PSNetworkWatcher

Parámetros: NetworkWatcher (ByValue)

String

Parámetros: NetworkWatcherName (ByValue)

Nullable<T>[[System.Int32, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]

Salidas

PSPacketCaptureResult

Notas

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