التشغيل السريع: تشغيل استعلام Resource Graph باستخدام Azure PowerShell

يصف هذا التشغيل السريع كيفية تشغيل استعلام Azure Resource Graph باستخدام الوحدة النمطية Az.ResourceGraph ل Azure PowerShell. يتم تضمين الوحدة النمطية مع أحدث إصدار من Azure PowerShell وتضيف cmdlets ل Resource Graph.

توضح المقالة أيضا كيفية ترتيب (فرز) وتقييد نتائج الاستعلام. يمكنك تشغيل استعلام للموارد في المستأجر أو مجموعات الإدارة أو الاشتراكات.

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

تثبيت الوحدة

إذا قمت بتثبيت أحدث إصدارات PowerShell وAzure PowerShell، فلديك بالفعل الوحدة النمطية Az.ResourceGraph والإصدار المطلوب من PowerShellGet.

تثبيت الوحدة النمطية الاختيارية

استخدم الخطوات التالية لتثبيت Az.ResourceGraph الوحدة بحيث يمكنك استخدام Azure PowerShell لتشغيل استعلامات Azure Resource Graph. تتطلب الوحدة النمطية Azure Resource Graph PowerShellGet الإصدار 2.0.1 أو أعلى.

  1. تحقق من إصدار PowerShellGet الخاص بك:

    Get-Module -Name PowerShellGet
    

    إذا كنت بحاجة إلى التحديث، فانتقل إلى PowerShellGet.

  2. تركيب الوحدة النمطية:

    Install-Module -Name Az.ResourceGraph -Repository PSGallery -Scope CurrentUser
    

    يقوم الأمر بتثبيت الوحدة النمطية في CurrentUser النطاق. إذا كنت بحاجة إلى التثبيت في AllUsers النطاق، فقم بتشغيل التثبيت من جلسة عمل PowerShell إدارية.

  3. تحقق من تثبيت الوحدة النمطية:

    Get-Command -Module Az.ResourceGraph -CommandType Cmdlet
    

    يعرض Search-AzGraph الأمر إصدار cmdlet ويحمل الوحدة النمطية في جلسة عمل PowerShell.

قم بالاتصال بـ Azure

من جلسة Visual Studio Code الطرفية، اتصل ب Azure. إذا كان لديك أكثر من اشتراك واحد، فقم بتشغيل الأوامر لتعيين السياق إلى اشتراكك. استبدل <subscriptionID> بمعرف اشتراك Azure الخاص بك.

Connect-AzAccount

# Run these commands if you have multiple subscriptions
Get-AzSubScription
Set-AzContext -Subscription <subscriptionID>

تشغيل استعلام

بعد إضافة الوحدة النمطية إلى بيئتك، يمكنك تشغيل استعلام يستند إلى المستأجر. يقوم الاستعلام في هذا المثال بإرجاع خمسة موارد Azure مع name و type لكل مورد. للاستعلام حسب مجموعة الإدارة أو الاشتراك، استخدم -ManagementGroup المعلمات أو -Subscription.

  1. تشغيل استعلام Azure Resource Graph باستخدام Search-AzGraph cmdlet:

    Search-AzGraph -Query 'Resources | project name, type | limit 5'
    

    لا يستخدم مثال الاستعلام هذا معدل فرز مثل order by. إذا قمت بتشغيل الاستعلام عدة مرات، فقد ينتج عنه مجموعة مختلفة من الموارد لكل طلب.

  2. تحديث الاستعلام إلى order by الخاصية name :

    Search-AzGraph -Query 'Resources | project name, type | limit 5 | order by name asc'
    

    مثل الاستعلام السابق، إذا قمت بتشغيل هذا الاستعلام عدة مرات، فقد ينتج عن ذلك مجموعة مختلفة من الموارد لكل طلب. إن ترتيب أوامر الاستعلام مهم. في هذا المثال، يأتي order by بعد limit. يحدد الاستعلام النتائج بخمسة موارد ثم يأمر تلك النتائج بالاسم.

  3. تحديث الاستعلام إلى order by الخاصية name ثم limit الإخراج إلى خمس نتائج:

    Search-AzGraph -Query 'Resources | project name, type | order by name asc | limit 5'
    

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

إذا لم يرجع الاستعلام نتائج من اشتراك لديك حق الوصول إليه بالفعل، فلاحظ أن Search-AzGraph cmdlet افتراضيا للاشتراكات في السياق الافتراضي. لمشاهدة قائمة معرفات الاشتراك التي تعد جزءا من السياق الافتراضي، قم بتشغيل هذا (Get-AzContext).Account.ExtendedProperties.Subscriptions إذا كنت ترغب في البحث عبر جميع الاشتراكات التي لديك حق الوصول إليها، قم بتعيين PSDefaultParameterValues ل Search-AzGraph cmdlet عن طريق تشغيل $PSDefaultParameterValues=@{"Search-AzGraph:Subscription"= $(Get-AzSubscription).ID}

تنظيف الموارد

لتسجيل الخروج من جلسة عمل Azure PowerShell:

Disconnect-AzAccount

خطوات التنظيف الاختيارية

إذا قمت بتثبيت أحدث إصدار من Azure PowerShell، Az.ResourceGraph يتم تضمين الوحدة النمطية ولا يجب إزالتها. الخطوات التالية اختيارية إذا قمت بتثبيت يدوي للوحدة Az.ResourceGraph النمطية وتريد إزالة الوحدة النمطية.

لإزالة الوحدة النمطية Az.ResourceGraph من جلسة عمل PowerShell، قم بتشغيل الأمر التالي:

Remove-Module -Name Az.ResourceGraph

لإلغاء تثبيت الوحدة النمطية Az.ResourceGraph من الكمبيوتر، قم بتشغيل الأمر التالي:

Uninstall-Module -Name Az.ResourceGraph

قد يتم عرض رسالة تفيد بأن الوحدة النمطية Az.ResourceGraph قيد الاستخدام حاليا. إذا كان الأمر كذلك، فأنت بحاجة إلى إيقاف تشغيل جلسة عمل PowerShell وبدء جلسة عمل جديدة. ثم قم بتشغيل الأمر لإلغاء تثبيت الوحدة النمطية من الكمبيوتر الخاص بك.

الخطوات التالية

في هذا التشغيل السريع، أضفت الوحدة النمطية Resource Graph إلى بيئة Azure PowerShell وقمت بتشغيل استعلام. لمعرفة المزيد، انتقل إلى صفحة تفاصيل لغة الاستعلام.