Azure Network Watcher 拡張機能を最新バージョンに更新する

  • [アーティクル]

Azure Network Watcher は、Azure ネットワークを監視する、ネットワーク パフォーマンスの監視、診断、および分析サービスです。 Network Watcher Agent 仮想マシン (VM) 拡張機能は、オンデマンドでネットワーク トラフィックをキャプチャするためと、Azure VM に関するその他の高度な機能を使用するための要件です。 これは、接続モニター、接続のトラブルシューティング、パケット キャプチャによって使用されます。

前提条件

  • アクティブなサブスクリプションが含まれる Azure アカウント。 アカウントがない場合は、無料アカウントを作成してください。
  • Network Watcher 拡張機能がインストールされている Azure 仮想マシン (VM)。

最新バージョン

Network Watcher 拡張機能の最新バージョンは 1.4.3206.1 です。

最新バージョンを特定する

az vm extension image list コマンドを使用して、ご使用の VM オペレーティング システム用の Network Watcher 拡張機能の最新バージョンを特定します。

# Identify latest version of Network Watcher extension for Linux.
az vm extension image list --name 'NetworkWatcherAgentLinux' --publisher 'Microsoft.Azure.NetworkWatcher' --latest --location 'eastus'

PowerShell スクリプトを使用して拡張機能を更新する

大規模なデプロイがある場合は、PowerShell スクリプトを使用して複数の VM を一度に更新します。 次の PowerShell スクリプトを使用すると、サブスクリプション内のすべての Windows VM の Network Watcher 拡張機能を更新できます。

<# 
    .SYNOPSIS 
    This script will scan all VMs in the provided subscription and upgrade any out of date AzureNetworkWatcherExtensions  
    .DESCRIPTION 
    This script should be no-op if AzureNetworkWatcherExtensions are up to date 
    Requires Azure PowerShell 4.2 or higher to be installed (e.g. Install-Module AzureRM). 
    .EXAMPLE 
    .\UpdateVMAgentsInSub.ps1 -SubID F4BC4873-5DAB-491E-B713-1358EF4992F2 -NoUpdate 
#>
 
[CmdletBinding()] 
param( 
    [Parameter(Mandatory=$true)] 
    [string] $SubID, 
    [Parameter(Mandatory=$false)] 
    [Switch] $NoUpdate = $false, 
    [Parameter(Mandatory=$false)] 
    [string] $MinVersion = "1.4.2573.1" 
)  
function NeedsUpdate($version) 
{ 
    if ([Version]$version -lt [Version]$MinVersion)
	{ 
        $lessThan = $true 
    }else{ 
        $lessThan = $false 
    } 
    return $lessThan 
}   
Write-Host "Scanning all VMs in the subscription: $($SubID)" 
Set-AzContext -SubscriptionId $SubID
$vms = Get-AzVM 
$foundVMs = $false 
Write-Host "Starting VM search, this may take a while" 
foreach ($vmName in $vms) 
{ 
    # Get Detailed VM info 
    $vm = Get-AzVM -ResourceGroupName $vmName.ResourceGroupName -Name $vmName.name -Status 
    $isitWindows = $vm.OsName -like "*Windows*"
 
    foreach ($extension in $vm.Extensions) 
    { 
        if ($extension.Name -eq "AzureNetworkWatcherExtension") 
        { 
            if (NeedsUpdate($extension.TypeHandlerVersion)) 
            { 
                $foundVMs = $true 
                if (-not ($NoUpdate)) 
                { 
                    Write-Host "Found VM that needs to be updated: subscriptions/$($SubID)/resourceGroups/$($vm.ResourceGroupName)/providers/Microsoft.Compute/virtualMachines/$($vm.Name) -> Updating " -NoNewline 
                    Remove-AzVMExtension -ResourceGroupName $vm.ResourceGroupName -VMName $vm.Name -Name "AzureNetworkWatcherExtension" -Force 
                    Write-Host "... " -NoNewline 
                    $type = if ($isitWindows) { "NetworkWatcherAgentWindows" } else { "NetworkWatcherAgentLinux" } 
                    Set-AzVMExtension -ResourceGroupName $vm.ResourceGroupName -Location $vmName.Location -VMName $vm.Name -Name "AzureNetworkWatcherExtension" -Publisher "Microsoft.Azure.NetworkWatcher" -Type $type -typeHandlerVersion $MinVersion
                    Write-Host "Done" 
                } 
                else 
                { 
                    Write-Host "Found $(if ($isitWindows) {"Windows"} else {"Linux"}) VM that needs to be updated: subscriptions/$($SubID)/resourceGroups/$($vm.ResourceGroupName)/providers/Microsoft.Compute/virtualMachines/$($vm.Name)" 
                } 
            } 
        } 
    } 
}
 
if ($foundVMs) 
{ 
    Write-Host "Finished $(if ($NoUpdate) {"searching"} else {"updating"}) out of date AzureNetworkWatcherExtension on VMs" 
} 
else 
{ 
    Write-Host "All AzureNetworkWatcherExtensions up to date" 
}

拡張機能を手動で更新する

拡張機能を更新するには、拡張機能のバージョンを把握しておく必要があります。

拡張機能のバージョンを確認する

拡張機能のバージョンは、Azure portal、Azure CLI、または PowerShell を使用して確認できます。

Azure ポータルの使用

  1. Azure portal で VM の [拡張機能] ペインにアクセスします。
  2. AzureNetworkWatcher 拡張機能を選択して、詳細ペインを表示します。
  3. [バージョン] フィールドに記載されているバージョン番号を見つけます。  

Azure CLI を使用する

Azure CLI のプロンプトで、次のコマンドを実行します。

az vm get-instance-view --resource-group  "SampleRG" --name "Sample-VM"

出力から "AzureNetworkWatcherExtension" を見つけて、出力の "TypeHandlerVersion" フィールドからバージョン番号を特定します。 

拡張機能に関する情報は、JSON 出力に複数回出現します。 拡張機能の完全なバージョン番号は、[拡張機能] ブロックで使用できます。

次のように表示されます。Azure CLI のスクリーンショット

PowerShell の使用

PowerShell プロンプトから、次のコマンドを実行します。

Get-AzVM -ResourceGroupName "SampleRG" -Name "Sample-VM" -Status

出力から Azure Network Watcher 拡張機能を見つけて、出力の "TypeHandlerVersion" フィールドからバージョン番号を特定します。  

次のように表示されます。PowerShell のスクリーンショット

拡張機能を更新する

お使いのバージョンが上記の最新バージョンよりも古い場合は、次のいずれかのオプションを使用して拡張機能を更新してください。

オプション 1: PowerShell の使用

次のコマンドを実行します。

#Linux command
Set-AzVMExtension -ResourceGroupName "myResourceGroup1" -Location "WestUS" -VMName "myVM1" -Name "AzureNetworkWatcherExtension" -Publisher "Microsoft.Azure.NetworkWatcher" -Type "NetworkWatcherAgentLinux"

#Windows command
Set-AzVMExtension -ResourceGroupName "myResourceGroup1" -Location "WestUS" -VMName "myVM1" -Name " AzureNetworkWatcherExtension" -Publisher "Microsoft.Azure.NetworkWatcher" -Type "NetworkWatcherAgentWindows" -ForceRerun "True"

それでもうまくいかない場合。 次の手順に従って、拡張機能を削除してからもう一度インストールし、最新バージョンをインストールします。

拡張機能の削除

#Same command for Linux and Windows
Remove-AzVMExtension -ResourceGroupName "SampleRG" -VMName "Sample-VM" -Name "AzureNetworkWatcherExtension"

拡張機能の再インストール

#Linux command
Set-AzVMExtension -ResourceGroupName "SampleRG" -Location "centralus" -VMName "Sample-VM" -Name "AzureNetworkWatcherExtension" -Publisher "Microsoft.Azure.NetworkWatcher" -Type "NetworkWatcherAgentLinux" -typeHandlerVersion "1.4"

#Windows command
Set-AzVMExtension -ResourceGroupName "SampleRG" -Location "centralus" -VMName "Sample-VM" -Name "AzureNetworkWatcherExtension" -Publisher "Microsoft.Azure.NetworkWatcher" -Type "NetworkWatcherAgentWindows" -typeHandlerVersion "1.4"

オプション 2:Azure CLI の使用

強制的にアップグレードします。

#Linux command
az vm extension set --resource-group "myResourceGroup1" --vm-name "myVM1" --name "NetworkWatcherAgentLinux" --publisher "Microsoft.Azure.NetworkWatcher" --force-update

#Windows command
az vm extension set --resource-group "myResourceGroup1" --vm-name "myVM1" --name "NetworkWatcherAgentWindows" --publisher "Microsoft.Azure.NetworkWatcher" --force-update

それでもうまくいかない場合は、拡張機能を削除してから再度インストールし、これらの手順に従って最新バージョンを自動的に追加します。

拡張機能を削除します。

#Same for Linux and Windows
az vm extension delete --resource-group "myResourceGroup1" --vm-name "myVM1" -n "AzureNetworkWatcherExtension"

拡張機能を再度インストールします。

#Linux command
az vm extension set --resource-group "DALANDEMO" --vm-name "Linux-01" --name "NetworkWatcherAgentLinux" --publisher "Microsoft.Azure.NetworkWatcher"

#Windows command
az vm extension set --resource-group "DALANDEMO" --vm-name "Linux-01" --name "NetworkWatcherAgentWindows" --publisher "Microsoft.Azure.NetworkWatcher"

オプション 3:VM を再起動する

Network Watcher 拡張機能の自動アップグレードが true に設定されている場合は、VM のインストールを再起動して最新の拡張機能にします。

サポート

この記事のいずれかについてさらにヘルプが必要な場合は、Linux または Windows 向けの Network Watcher 拡張機能のドキュメントを参照してください。 また、MSDN の Azure と Stack Overflow のフォーラムで Azure エキスパートに問い合わせることもできます。 または、Azure サポート インシデントを送信してください。 その場合は、Azure サポートのサイトに移動して、 [サポートの要求] をクリックします。 Azure サポートの使用方法の詳細については、「 Microsoft Azure サポートに関する FAQ」を参照してください。