تحديد موقع الأوامر

مكتمل

cmdlet (ينطق "command-let") هو أمر مجمع. يمكن تطوير أمر cmdlet في .NET أو .NET Core واستدعاؤه كأمر داخل PowerShell. تتوفر الآلاف من أوامر cmdlets في تثبيت PowerShell. يكمن التحدي في اكتشاف ماهية أوامر cmdlets وما يمكن أن تفعله لك.

تتم تسمية Cmdlets وفقا لمعيار تسمية الفعل- الاسم. يمكن أن يساعدك هذا النمط على فهم ما يفعلونه وكيفية البحث عنهم. كما أنه يساعد مطوري cmdlet على إنشاء أسماء متسقة. يمكنك مشاهدة قائمة الأفعال المعتمدة باستخدام Get-Verb cmdlet. يتم تنظيم الأفعال وفقا لنوع النشاط والدالة.

فيما يلي جزء من الإخراج من تشغيل Get-Verb:

Verb        AliasPrefix Group          Description
----        ----------- -----          -----------
Add         a           Common         Adds a resource to a container, or atta…
Clear       cl          Common         Removes all the resources from a contai…

تعرض هذه القائمة الفعل ووصفه. يجب على مطوري Cmdlet استخدام فعل معتمد، وكذلك التأكد من أن وصف الفعل يناسب وظيفة cmdlet الخاصة بهم.

تسمح لك أوامر cmdlets الأساسية الثلاثة بالتعمق في أوامر cmdlets الموجودة وما تقوم به:

  • Get-Command: يسرد cmdlet Get-Command جميع أوامر cmdlets المتوفرة على النظام الخاص بك. قم بتصفية القائمة للعثور بسرعة على الأمر الذي تحتاجه.
  • الحصول على التعليمات: قم بتشغيل الأمر cmdlet الأساسي Get-Help لاستدعاء نظام تعليمات مضمن. يمكنك أيضا تشغيل أمر اسم مستعار help لاستدعاء Get-Help ولكن تحسين تجربة القراءة عن طريق ترقيم صفحات الاستجابة.
  • Get-Member: عند استدعاء أمر، تكون الاستجابة كائنا يحتوي على العديد من الخصائص. قم بتشغيل Get-Member core cmdlet للتعمق في هذه الاستجابة ومعرفة المزيد عنها.

تحديد موقع الأوامر باستخدام Get-Command

عند تشغيل Get-Command cmdlet في Cloud Shell، تحصل على قائمة بكل أمر مثبت في PowerShell. نظرا لتثبيت الآلاف من الأوامر، تحتاج إلى طريقة لتصفية الاستجابة حتى تتمكن من تحديد موقع الأمر الذي تحتاجه بسرعة.

لتصفية القائمة، ضع في اعتبارك معيار تسمية الفعل-الاسم ل cmdlets. على سبيل المثال، في الأمر Get-Random، Get هو الفعل Random هو الاسم. استخدم العلامات لاستهداف الفعل أو الاسم في الأمر الذي تريده. تتوقع العلامة التي تحددها قيمة سلسلة. يمكنك إضافة أحرف مطابقة الأنماط إلى تلك السلسلة للتأكد من التعبير، على سبيل المثال، يجب أن تبدأ قيمة العلامة أو تنتهي بسلسلة معينة.

توضح هذه الأمثلة كيفية استخدام العلامات لتصفية قائمة أوامر:

  • -الاسم: تستهدف علامة -Noun جزء اسم الأمر المرتبط بالاسم. فيما يلي بحث نموذجي عن اسم أمر باستخدام الاسم المستعار كاسم نبحث عنه:

    Get-Command -Noun alias*
    

    يبحث هذا الأمر عن كافة أوامر cmdlets التي يبدأ جزء الاسم الخاص بها alias.

  • -الفعل: تستهدف علامة -Verb جزء اسم الأمر المرتبط بالفعل. يمكنك دمج علامة -Noun وعلامة -Verb لإنشاء استعلام بحث ونوع أكثر تفصيلا. فيما يلي مثال:

    Get-Command -Verb Get -Noun alias*
    

    الآن قمت بتضييق نطاق البحث لتحديد أن جزء الفعل يجب أن يتطابق مع Get، ويجب أن يتطابق جزء الاسم مع alias.