New-AzPacketCaptureScopeConfig

  • リファレンス
モジュール:
Az.Network

新しいパケット キャプチャ スコープ オブジェクトを作成します。

構文

New-AzPacketCaptureScopeConfig
   [-Include <String[]>]
   [-Exclude <String[]>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

説明

New-AzPacketCaptureScopeConfig コマンドレットは、新しいパケット キャプチャ スコープ オブジェクトを作成します。 このオブジェクトは、パケット キャプチャを実行するために指定された VMSS インスタンスを含めるか除外するために使用されます。 New-AzPacketCaptureScopeConfig コマンドレットは、複数の VMSS インスタンス名を使用して、構成可能なキャプチャ セッションを有効または無効にすることができます。

例

例 1: Include Scope に複数の VMSS インスタンスを含むパケット キャプチャを作成する

$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

この例では、"PacketCaptureTest" という名前のパケット キャプチャを作成し、[スコープを含める] に複数の VMSS インスタンスと制限時間を設定します。 セッションが完了すると、指定したストレージ アカウントに保存されます。 注: パケット キャプチャを作成するには、Azure Network Watcher 拡張機能をターゲット仮想マシンにインストールする必要があります。

例 2: 除外スコープに複数の VMSS インスタンスを含むパケット キャプチャを作成する

$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

この例では、除外スコープに複数の VMSS インスタンスがある "PacketCaptureTest" という名前のパケット キャプチャを作成します。つまり、これらの指定されたインスタンスとは別に、パケット キャプチャは他のすべてのインスタンスと時間制限で動作します。 セッションが完了すると、指定したストレージ アカウントに保存されます。 注: パケット キャプチャを作成するには、Azure Network Watcher 拡張機能をターゲット仮想マシンにインストールする必要があります。

パラメーター

-DefaultProfile

Azure との通信のために使用される資格情報、アカウント、テナント、サブスクリプションです。

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

-Exclude

スコープで除外するマシン

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

-Include

スコープに含めるマシン

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

入力

String[]

出力

PSPacketCaptureMachineScope