PowerShell を使用して Azure Network Watcher を使用して仮想マシンスケールセットのパケットキャプチャを管理する

[アーティクル]
06/07/2022

Azure portal で操作する
PowerShell

Network Watcher パケットキャプチャを使用すると、仮想マシンスケールセットインスタンスとの間のトラフィックを追跡するキャプチャセッションを作成できます。キャプチャセッションにはフィルターが用意されており、必要なトラフィックのみを確実にキャプチャできます。パケットキャプチャは、ネットワークの異常を、事後対応的にもプロアクティブにも診断するのに役立ちます。その他の用途としては、ネットワーク統計情報の収集、ネットワーク侵入に関する情報の取得、クライアントとサーバー間の通信のデバッグなどがあります。パケットキャプチャをリモートでトリガーできるため、目的の仮想マシンスケールセットインスタンスでパケットキャプチャを手動で実行する負担が軽減され、貴重な時間を節約できます。

この記事では、パケットキャプチャに現在使用できるさまざまな管理タスクについて説明します。

パケットキャプチャ を開始する
パケットキャプチャ を停止する
パケットキャプチャ を削除する
パケットキャプチャ をダウンロードする

開始する前に

この記事では、次のリソースがあることを前提としています。

パケットキャプチャを作成するリージョン内の Network Watcher のインスタンス

大事な

パケットキャプチャには、仮想マシンスケールセット拡張機能 AzureNetworkWatcherExtensionが必要です。 Windows VM に拡張機能をインストールする場合は、Windows 用の Azure Network Watcher Agent 仮想マシン拡張機能、Linux 用の Azure Network Watcher Agent 仮想マシン拡張機能参照してください。

仮想マシンスケールセット拡張機能をインストールする

手順 1

$vmss = Get-AzVmss -ResourceGroupName "myResourceGroup" -VMScaleSetName "myScaleSet"

手順 2

仮想マシンスケールセット/仮想マシンスケールセットインスタンスに NetworkWatcherAgent をインストールする

Add-AzVmssExtension -VirtualMachineScaleSet $vmss -Name "AzureNetworkWatcherExtension" -Publisher "Microsoft.Azure.NetworkWatcher" -Type "NetworkWatcherAgentWindows" -TypeHandlerVersion "1.4" -AutoUpgradeMinorVersion $True

Update-AzVmss -ResourceGroupName "$resourceGroupName" -Name $virtualMachineScaleSetName -VirtualMachineScaleSet $vmss
Update-AzVmssInstance -ResourceGroupName "$resourceGroupName" -VMScaleSetName $vmss.Name -InstanceId 0
> The `Set-AzVMExtension` cmdlet may take several minutes to complete.

手順 3

エージェントがインストールされていることを確認するには、手順 1. に従います。

Get-AzVMss -ResourceGroupName $vmss.ResourceGroupName  -VMNScaleSetName $vmss.Name

パケットキャプチャを開始する

上記の手順が完了すると、パケットキャプチャエージェントが仮想マシンスケールセットにインストールされます。

手順 1

次の手順では、Network Watcher インスタンスを取得します。この変数は、手順 4 で New-AzNetworkWatcherPacketCapture コマンドレットに渡されます。

$networkWatcher = Get-AzNetworkWatcher  | Where {$_.Location -eq "westcentralus" }

手順 2

ストレージアカウントを取得します。このストレージアカウントは、パケットキャプチャファイルを格納するために使用されます。

$storageAccount = Get-AzStorageAccount -ResourceGroupName testrg -Name testrgsa123

手順 3

フィルターを使用して、パケットキャプチャによって格納されるデータを制限できます。次の例では、2 つのフィルターを設定します。 1 つのフィルターは、ローカル IP 10.0.0.3 から宛先ポート 20、80、443 への送信 TCP トラフィックのみを収集します。 2 番目のフィルターでは、UDP トラフィックのみが収集されます。

$filter1 = New-AzPacketCaptureFilterConfig -Protocol TCP -RemoteIPAddress "1.1.1.1-255.255.255.255" -LocalIPAddress "10.0.0.3" -LocalPort "1-65535" -RemotePort "20;80;443"
$filter2 = New-AzPacketCaptureFilterConfig -Protocol UDP

手記

1 つのパケットキャプチャに対して複数のフィルターを定義できます。

手順 4

パケットキャプチャのスコープを作成する

$s1 = New-AzPacketCaptureScopeConfig -Include "0", "1"

手順 5

New-AzNetworkWatcherPacketCaptureV2 コマンドレットを実行してパケットキャプチャプロセスを開始し、前の手順で取得した必要な値を渡します。


New-AzNetworkWatcherPacketCaptureV2 -NetworkWatcher $networkwatcher -PacketCaptureName $pcName -TargetId $vmss.Id -TargetType "azurevmss" -StorageAccountId $storageAccount.id -Filter $filter1, $filter2

パケットキャプチャを取得する

Get-AzNetworkWatcherPacketCapture コマンドレットを実行すると、現在実行中の状態または完了したパケットキャプチャの状態が取得されます。

Get-AzNetworkWatcherPacketCapture -NetworkWatcher $networkWatcher -PacketCaptureName "PacketCaptureTest"

次の例は、Get-AzNetworkWatcherPacketCapture コマンドレットからの出力です。次の例は、キャプチャが完了した後です。 PacketCaptureStatus 値は Stoped で、StopReason は TimeExceeded です。この値は、パケットキャプチャが成功し、所定の時間が完了したことを示します。

Name                    : PacketCaptureTest
Id                      : /subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/NetworkWatcherRG/providers/Microsoft.Network/networkWatcher
                          s/NetworkWatcher_westcentralus/packetCaptures/PacketCaptureTest
Etag                    : W/"4b9a81ed-dc63-472e-869e-96d7166ccb9b"
ProvisioningState       : Succeeded
Target                  : /subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/testrg/providers/Microsoft.Compute/virtualMachines/testvm1
BytesToCapturePerPacket : 0
TotalBytesPerSession    : 1073741824
TimeLimitInSeconds      : 60
StorageLocation         : {
                            "StorageId": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/testrg/providers/Microsoft.Storage/storageA
                          ccounts/examplestorage",
                            "StoragePath": "https://examplestorage.blob.core.windows.net/network-watcher-logs/subscriptions/00000000-0000-0000-0000-00000
                          0000000/resourcegroups/testrg/providers/microsoft.compute/virtualmachines/testvm1/2017/02/01/packetcapture_22_42_48_238.cap"
                          }
Filters                 : [
                            {
                              "Protocol": "TCP",
                              "RemoteIPAddress": "1.1.1.1-255.255.255",
                              "LocalIPAddress": "10.0.0.3",
                              "LocalPort": "1-65535",
                              "RemotePort": "20;80;443"
                            },
                            {
                              "Protocol": "UDP",
                              "RemoteIPAddress": "",
                              "LocalIPAddress": "",
                              "LocalPort": "",
                              "RemotePort": ""
                            }
                          ]
CaptureStartTime        : 2/1/2017 10:43:01 PM
PacketCaptureStatus     : Stopped
StopReason              : TimeExceeded
PacketCaptureError      : []

パケットキャプチャを停止する

Stop-AzNetworkWatcherPacketCapture コマンドレットを実行すると、キャプチャセッションが進行中の場合は停止します。

Stop-AzNetworkWatcherPacketCapture -NetworkWatcher $networkWatcher -PacketCaptureName "PacketCaptureTest"

手記

このコマンドレットは、現在実行中のキャプチャセッションまたは既に停止している既存のセッションで実行された場合、応答を返しません。

パケットキャプチャを削除する

Remove-AzNetworkWatcherPacketCapture -NetworkWatcher $networkWatcher -PacketCaptureName "PacketCaptureTest"

手記

パケットキャプチャを削除しても、ストレージアカウント内のファイルは削除されません。

パケットキャプチャをダウンロードする

パケットキャプチャセッションが完了すると、キャプチャファイルを BLOB ストレージまたはインスタンス上のローカルファイルにアップロードできます。パケットキャプチャの保存場所は、セッションの作成時に定義されます。ストレージアカウントに保存されているこれらのキャプチャファイルにアクセスするための便利なツールは、Microsoft Azure Storage Explorer です。このツールは、次の場所からダウンロードできます:https://storageexplorer.com/

ストレージアカウントが指定されている場合、パケットキャプチャファイルは次の場所にあるストレージアカウントに保存されます。

複数のインスタンスが選択されている場合

https://{storageAccountName}.blob.core.windows.net/network-watcher-logs/subscriptions/{subscriptionId}/resourcegroups/{storageAccountResourceGroup}/providers/microsoft.compute/virtualmachinescalesets/{VMSSName}/{year}/{month}/{day}/packetCapture_{creationTime}

単一インスタンスが選択されている場合

https://{storageAccountName}.blob.core.windows.net/network-watcher-logs/subscriptions/{subscriptionId}/resourcegroups/{storageAccountResourceGroup}/providers/microsoft.compute/virtualmachinescalesets/{VMSSName}/virtualMachines/{instance}/{year}/{month}/{day}/packetCapture_{creationTime}.cap

次の手順

IP フローの確認に移動して、VM の入出トラフィックが許可されているかを確認する

次の方法で共有

PowerShell を使用して Azure Network Watcher を使用して仮想マシンスケールセットのパケットキャプチャを管理する

開始する前に

仮想マシンスケールセット拡張機能をインストールする

手順 1

手順 2

手順 3

パケットキャプチャを開始する

手順 1

手順 2

手順 3

手順 4

手順 5

パケットキャプチャを取得する

パケットキャプチャを停止する

パケットキャプチャを削除する

パケットキャプチャをダウンロードする

次の手順

その他のリソース

次の方法で共有

PowerShell を使用して Azure Network Watcher を使用して仮想マシン スケール セットのパケット キャプチャを管理する

開始する前に

仮想マシン スケール セット拡張機能をインストールする

手順 1

手順 2

手順 3

パケット キャプチャを開始する

手順 1

手順 2

手順 3

手順 4

手順 5

パケット キャプチャを取得する

パケット キャプチャを停止する

パケット キャプチャを削除する

パケット キャプチャをダウンロードする

次の手順

その他のリソース

PowerShell を使用して Azure Network Watcher を使用して仮想マシンスケールセットのパケットキャプチャを管理する

仮想マシンスケールセット拡張機能をインストールする

パケットキャプチャを開始する

パケットキャプチャを取得する

パケットキャプチャを停止する

パケットキャプチャを削除する

パケットキャプチャをダウンロードする