إدارة ملحق الجهاز الظاهري ل Network Watcher Agent لنظام التشغيل Windows

ملحق الجهاز الظاهري لعامل مراقب الشبكة هو مطلب لبعض ميزات Azure Network Watcher التي تلتقط نسبة استخدام الشبكة لتشخيص ومراقبة أجهزة Azure الظاهرية (VMs). لمزيد من المعلومات، راجع ما هو Azure Network Watcher؟

في هذه المقالة، ستتعرف على كيفية تثبيت عامل Network Watcher ل Windows وإلغاء تثبيته. لا يعطل تثبيت العامل، أو يتطلب إعادة تشغيل الجهاز الظاهري. إذا تم نشر الجهاز الظاهري بواسطة خدمة Azure، فتحقق من وثائق الخدمة لتحديد ما إذا كان يسمح بتثبيت الملحقات في الجهاز الظاهري أم لا.

المتطلبات الأساسية

المدخل

• جهاز Azure Windows الظاهري (VM). لمزيد من المعلومات، راجع إصدارات Windows المدعومة.

• اتصال TCP الصادر إلى 169.254.169.254 مرارا port 80 وتكرارا 168.63.129.16port 8037. يستخدم العامل عناوين IP هذه للاتصال بالنظام الأساسي Azure.

• الاتصال بالإنترنت: يتطلب Network Watcher Agent اتصالا بالإنترنت حتى تعمل بعض الميزات بشكل صحيح. على سبيل المثال، يتطلب الاتصال بحساب التخزين الخاص بك لتحميل التقاطات الحزمة. لمزيد من المعلومات، راجع نظرة عامة على التقاط الحزمة.

بوويرشيل

• جهاز Azure Windows الظاهري (VM). لمزيد من المعلومات، راجع إصدارات Windows المدعومة.

• اتصال TCP الصادر إلى 169.254.169.254 مرارا port 80 وتكرارا 168.63.129.16port 8037. يستخدم العامل عناوين IP هذه للاتصال بالنظام الأساسي Azure.

• الاتصال بالإنترنت: يتطلب Network Watcher Agent اتصالا بالإنترنت حتى تعمل بعض الميزات بشكل صحيح. على سبيل المثال، يتطلب الاتصال بحساب التخزين الخاص بك لتحميل التقاطات الحزمة. لمزيد من المعلومات، راجع نظرة عامة على التقاط الحزمة.

• Azure Cloud Shell أو Azure PowerShell.

  تعمل الخطوات الواردة في هذه المقالة على تشغيل أوامر Cmdlets Azure PowerShell بشكل تفاعلي في Azure Cloud Shell. لتشغيل الأوامر في Cloud Shell، حدد Open Cloud Shell في الزاوية العلوية اليسرى من كتلة التعليمات البرمجية. حدد نسخ لنسخ التعليمات البرمجية ثم لصقها في Cloud Shell لتشغيلها. يمكنك أيضا تشغيل Cloud Shell من داخل مدخل Microsoft Azure.

  يمكنك أيضا تثبيت Azure PowerShell محليا لتشغيل cmdlets. إذا قمت بتشغيل PowerShell محليا، فقم بتسجيل الدخول إلى Azure باستخدام الاتصال-AzAccount cmdlet.

Azure CLI

• جهاز Azure Windows الظاهري (VM). لمزيد من المعلومات، راجع إصدارات Windows المدعومة.

• اتصال TCP الصادر إلى 169.254.169.254 مرارا port 80 وتكرارا 168.63.129.16port 8037. يستخدم العامل عناوين IP هذه للاتصال بالنظام الأساسي Azure.

• الاتصال بالإنترنت: يتطلب Network Watcher Agent اتصالا بالإنترنت حتى تعمل بعض الميزات بشكل صحيح. على سبيل المثال، يتطلب الاتصال بحساب التخزين الخاص بك لتحميل التقاطات الحزمة. لمزيد من المعلومات، راجع نظرة عامة على التقاط الحزمة.

• Azure Cloud ShellأوAzure CLI.

  تعمل الخطوات الواردة في هذه المقالة على تشغيل أوامر Azure CLI بشكل تفاعلي في Azure Cloud Shell. لتشغيل الأوامر في Cloud Shell، حدد Open Cloud Shell في الزاوية العلوية اليسرى من كتلة التعليمات البرمجية. حدد نسخ لنسخ التعليمات البرمجية، ولصقها في Cloud Shell لتشغيلها. يمكنك أيضا تشغيل Cloud Shell من داخل مدخل Microsoft Azure.

  يمكنك أيضا تثبيت Azure CLI محليا لتشغيل الأوامر. إذا قمت بتشغيل Azure CLI محليا، فقم بتسجيل الدخول إلى Azure باستخدام الأمر az login .

Resource Manager

• جهاز Azure Windows الظاهري (VM). لمزيد من المعلومات، راجع إصدارات Windows المدعومة.

• اتصال TCP الصادر إلى 169.254.169.254 مرارا port 80 وتكرارا 168.63.129.16port 8037. يستخدم العامل عناوين IP هذه للاتصال بالنظام الأساسي Azure.

• الاتصال بالإنترنت: يتطلب Network Watcher Agent اتصالا بالإنترنت حتى تعمل بعض الميزات بشكل صحيح. على سبيل المثال، يتطلب الاتصال بحساب التخزين الخاص بك لتحميل التقاطات الحزمة. لمزيد من المعلومات، راجع نظرة عامة على التقاط الحزمة.

• تم تثبيت Azure PowerShell أو Azure CLI محليا لنشر القالب.

  • يمكنك تثبيت Azure PowerShell لتشغيل cmdlets. استخدم الاتصال-AzAccount cmdlet لتسجيل الدخول إلى Azure.

  • يمكنك تثبيت Azure CLI لتشغيل الأوامر. استخدم الأمر az login لتسجيل الدخول إلى Azure.

أنظمة التشغيل المدعومة

يمكن تثبيت ملحق عامل Network Watcher ل Windows على إصدارات Windows Server 2012 و2012 R2 و2016 و2019 و2022. حاليا، خادم Nano غير مدعوم.

مخطط الملحق

يعرض JSON التالي مخطط ملحق Network Watcher Agent. لا يتطلب الملحق أو يدعم أي إعدادات يوفرها المستخدم، ويعتمد على تكوينه الافتراضي.

{
    "name": "[concat(parameters('vmName'), '/AzureNetworkWatcherExtension')]",
    "type": "Microsoft.Compute/virtualMachines/extensions",
    "apiVersion": "2023-03-01",
    "location": "[resourceGroup().location]",
    "dependsOn": [
        "[concat('Microsoft.Compute/virtualMachines/', parameters('vmName'))]"
    ],
    "properties": {
        "autoUpgradeMinorVersion": true,
        "publisher": "Microsoft.Azure.NetworkWatcher",
        "type": "NetworkWatcherAgentWindows",
        "typeHandlerVersion": "1.4"
    }
}

قائمة الملحقات المثبتة

المدخل

من صفحة الجهاز الظاهري في مدخل Microsoft Azure، يمكنك عرض الملحق المثبت باتباع الخطوات التالية:

1. ضمن الإعدادات، حدد Extensions + applications.

2. في علامة التبويب Extensions ، يمكنك مشاهدة جميع الملحقات المثبتة على الجهاز الظاهري. إذا كانت القائمة طويلة، يمكنك استخدام مربع البحث لتصفية القائمة.

   

بوويرشيل

استخدم Get-AzVMExtension cmdlet لسرد جميع الملحقات المثبتة على الجهاز الظاهري:

# List the installed extensions on the virtual machine.
Get-AzVMExtension -ResourceGroupName 'myResourceGroup' -VMName 'myVM' | format-table Name, Publisher, ExtensionType, AutoUpgradeMinorVersion, EnableAutomaticUpgrade

يسرد إخراج cmdlet الملحقات المثبتة:

Name                         Publisher                      ExtensionType              AutoUpgradeMinorVersion EnableAutomaticUpgrade
----                         ---------                      -------------              ----------------------- ----------------------
AzureNetworkWatcherExtension Microsoft.Azure.NetworkWatcher NetworkWatcherAgentWindows                    True                   True

Azure CLI

استخدم الأمر az vm extension list لسرد جميع الملحقات المثبتة على الجهاز الظاهري:

# List the installed extensions on the virtual machine.
az vm extension list --resource-group 'myResourceGroup' --vm-name 'myVM' --out table

يسرد إخراج الأمر الملحقات المثبتة:

Name                          ProvisioningState    Publisher                       Version    AutoUpgradeMinorVersion
----------------------------  -------------------  ------------------------------  ---------  -------------------------
AzureNetworkWatcherExtension  Succeeded            Microsoft.Azure.NetworkWatcher  1.4        True

Resource Manager

‏‫غير متوفر‬

تثبيت ملحق الجهاز الظاهري لعامل Network Watcher

المدخل

من صفحة الجهاز الظاهري في مدخل Microsoft Azure، يمكنك تثبيت ملحق الجهاز الظاهري لعامل Network Watcher باتباع الخطوات التالية:

1. ضمن الإعدادات، حدد Extensions + applications.

2. حدد + Add وابحث عن Network Watcher Agent وقم بتثبيته. إذا كان الملحق مثبتا بالفعل، يمكنك رؤيته في قائمة الملحقات.

   

3. في مربع البحث تثبيت ملحق، أدخل Network Watcher Agent for Windows. حدد الملحق من القائمة وحدد التالي.

   

4. حدد مراجعة + إنشاء، ثم حدد إنشاء.

بوويرشيل

استخدم Set-AzVMExtension cmdlet لتثبيت ملحق الجهاز الظاهري لعامل Network Watcher على الجهاز الظاهري:

# Install Network Watcher Agent for Windows on the virtual machine.
Set-AzVMExtension -Name 'AzureNetworkWatcherExtension' -Publisher 'Microsoft.Azure.NetworkWatcher' -ExtensionType 'NetworkWatcherAgentWindows' -EnableAutomaticUpgrade 1 -TypeHandlerVersion '1.4' -ResourceGroupName 'myResourceGroup' -VMName 'myVM' 

بمجرد اكتمال التثبيت بنجاح، سترى الإخراج التالي:

RequestId IsSuccessStatusCode StatusCode ReasonPhrase
--------- ------------------- ---------- ------------
                         True         OK 

Azure CLI

استخدم الأمر az vm extension set لتثبيت ملحق الجهاز الظاهري لعامل Network Watcher على الجهاز الظاهري:

# Install Network Watcher Agent for Windows on the virtual machine.
az vm extension set --name 'NetworkWatcherAgentWindows' --extension-instance-name 'AzureNetworkWatcherExtension' --publisher 'Microsoft.Azure.NetworkWatcher' --enable-auto-upgrade 'true' --version '1.4' --resource-group 'myResourceGroup' --vm-name 'myVM'

Resource Manager

استخدم قالب Azure Resource Manager التالي (قالب ARM) لتثبيت ملحق الجهاز الظاهري لعامل Network Watcher على جهاز ظاهري يعمل بنظام Windows:

{
    "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "vmName": {
                "type": "string"
            }
    },
    "variables": {},
    "resources": [
        {
                "name": "[parameters('vmName')]",
                "type": "Microsoft.Compute/virtualMachines",
                "apiVersion": "2023-03-01",
                "location": "[resourceGroup().location]",
                "properties": {
                }
            },
            {
                "name": "[concat(parameters('vmName'), '/AzureNetworkWatcherExtension')]",
                "type": "Microsoft.Compute/virtualMachines/extensions",
                "apiVersion": "2023-03-01",
                "location": "[resourceGroup().location]",
                "dependsOn": [
                    "[concat('Microsoft.Compute/virtualMachines/', parameters('vmName'))]"
                ],
                "properties": {
                    "autoUpgradeMinorVersion": true,
                    "publisher": "Microsoft.Azure.NetworkWatcher",
                    "type": "NetworkWatcherAgentWindows",
                    "typeHandlerVersion": "1.4"
                }
            }
    ],
    "outputs": {}
}

يمكنك استخدام إما Azure PowerShell أو Azure CLI لنشر قالب Resource Manager:

# Deploy the JSON template file using Azure PowerShell.
New-AzResourceGroupDeployment -ResourceGroupName 'myResourceGroup' -TemplateFile 'agent.json'

# Deploy the JSON template file using the Azure CLI.
az deployment group create --resource-group 'myResourceGroup' --template-file 'agent.json'

إلغاء تثبيت ملحق الجهاز الظاهري لعامل مراقب الشبكة

المدخل

من صفحة الجهاز الظاهري في مدخل Microsoft Azure، يمكنك إلغاء تثبيت ملحق الجهاز الظاهري لعامل Network Watcher باتباع الخطوات التالية:

1. ضمن الإعدادات، حدد Extensions + applications.

2. حدد AzureNetworkWatcherExtension من قائمة الملحقات، ثم حدد إلغاء التثبيت.

   

   إشعار

   قد ترى ملحق الجهاز الظاهري لعامل مراقب الشبكة المسمى بشكل مختلف عن AzureNetworkWatcherExtension.

بوويرشيل

استخدم Remove-AzVMExtension cmdlet لإزالة ملحق الجهاز الظاهري لعامل مراقب الشبكة من الجهاز الظاهري:

# Uninstall Network Watcher Agent VM extension.
Remove-AzureVMExtension -Name 'AzureNetworkWatcherExtension' -ResourceGroupName 'myResourceGroup' -VMName 'myVM'

Azure CLI

استخدم الأمر az vm extension delete لإزالة ملحق الجهاز الظاهري لعامل Network Watcher من الجهاز الظاهري:

# Uninstall Network Watcher Agent VM extension.
az vm extension delete --name 'AzureNetworkWatcherExtension' --resource-group 'myResourceGroup' --vm-name 'myVM'

Resource Manager

‏‫غير متوفر‬

الأسئلة الشائعة (FAQ)

للحصول على إجابات للأسئلة المتداولة حول Network Watcher Agent، راجع الأسئلة المتداولة حول Network Watcher Agent.

المحتوى ذو الصلة

• تحديث ملحق Azure Network Watcher إلى أحدث إصدار.
• وثائق Network Watcher.
• Microsoft Q&A - Network Watcher.