لا توجد cmdlets أكثر مألوفة للمبتدئين والخبراء على حد سواء من الأمر والقدر مثل أمر مساعدة PowerShell، Get-Help. بفضل نظام المساعدة المتكامل والقابل للتحديث في PowerShell، يعد أمر Get-Help في PowerShell الطريقة التي تكتشف بها ما الذي تقوم به الأوامر ومعلماتها، وحتى (نأمل) العديد من الأمثلة المفيدة حول كيفية استخدام الأمر.
كل cmdlet ووظيفة تصادفها من المفترض أن تحتوي على محتوى مساعدة يتم بناؤه معها والذي يمكن لأمر Get-Help في PowerShell قراءته. أقول “المفترض أن” لأن بعض المؤلفين للأسف لا يضمنون محتوى المساعدة.
يمكن العثور على محتوى المساعدة المرتبط بالأوامر عن طريق تشغيل Get-Help. يقرأ هذا الأمر كل من المساعدة المستندة إلى التعليقات والمستندة إلى XML التي يتم بناؤها بواسطة مؤلف الcmdlet أو الوظيفة.
استخدام الـ cmdlet Get-Help الأكثر شيوعًا هو استخدامه للعثور على محتوى مساعدة لأمر معين. على سبيل المثال، ربما اكتشفت أمرًا جديدًا يسمى Get-Content باستخدام أمر Get-Command وتريد معرفة مزيد من المعلومات حوله. ستستخدم المعلمة Name على Get-Help. ستُعيد هذه الخطوة مجموعة أساسية من المعلومات حول هذا الأمر كما يمكنك أن ترى أدناه.
ستلاحظ أنه على الرغم من أن الكثير من المعلومات تعود، إلا أنها مجرد ملخص للأشياء التي يمكنك القيام بها. ولن تعلم أبدًا أن Get-Help يمكن أن يعيد أنواعًا أخرى من محتوى المساعدة مثل الأمثلة.
البحث عن معلومات المعامل
يمكنك التنقل في محتوى المساعدة بعدة طرق مختلفة. واحدة من تلك الطرق هي البحث عن معلومات حول معامل واحد من الأوامر. ربما في المثال الذي أستخدمه هنا، أرى إشارة إلى معامل Raw ولست متأكدًا تمامًا من وظيفة هذا المعامل. يمكنني استخدام معامل Parameter على Get-Help مع معامل Name لإرجاع معلومات فقط حول هذا المعامل الخاص بالأمر.
PowerShell Get-Help والأمثلة
أحد أفضل الأشياء في نظام المساعدة في PowerShell هو أنه يدعم بشكل طبيعي الأمثلة. الأمثلة هي وسيلة ممتازة لرؤية، بسياق، كيفية استخدام أمر معين. إذا قام مؤلف الأمر بإضافة أمثلة إلى محتوى المساعدة الخاص به، يمكنك رؤية تلك الأمثلة باستخدام معامل Examples. عند استخدام هذا المعامل، سيعيد Get-Help واحدة أو أكثر من الأمثلة حول كيفية استخدام هذا الأمر في ظروف مختلفة.
الحصول على مساعدة مفصلة
الملخصات، ومعلومات المعامل، والأمثلة ليست الوحيدة المعلومات التي يعيد إيجادها أمر PowerShell Get-Help. في بعض الأحيان، قد تحتاج إلى رؤية جميع المعلومات المتاحة لأمر. في هذه الحالة، لديك دائمًا معاملات Detailed و Full المتاحة. كل واحدة من هذه المعاملات تعرض كمية متزايدة من المعلومات.
المعلمة Detailed تضيف وصفاً للمعلمات وأمثلة إلى العرض الأساسي للمساعدة. في الجوهر، تجمع بين استخدام المعلمة Examples وستعرض معلومات لجميع المعلمات كما لو كنت قد استخدمت المعلمة Parameter لجميع معلمات الأمر.
إذا لم تكن المعلمة Detailed كافية؛ يمكنك دائماً اللجوء إلى الطريقة النووية واسترجاع كل محتوى المساعدة بالمعلمة Full. هذه المعلمة لا تُصفّي المعلومات على الإطلاق. المعلمة Full تقرأ كل محتوى المساعدة المحدد لأمر معين.
الحصول على رسوم بيانية
إذا كنت ترغب في تمثيل رسومي أكثر للمساعدة، يمكنك أيضًا استخدام المعلمة ShowWindow. تقوم هذه المعلمة بفتح نافذة تسمح لك بالبحث بسهولة في محتوى المساعدة وعرض أجزاء معينة فقط عبر زر الإعدادات. يعتبر هذا العرض مفيدًا إذا كنت تريد حقًا التحقق من محتوى المساعدة.
الملخص
هناك بعض المعلمات الأخرى غير الشائعة التي يمكنك استخدامها مع أمر PowerShell Get-Help. إذا كنت مهتمًا بمعرفة المزيد، فأنت تعرف كيف تجد معلومات حول تلك المعلمات الإضافية، أليس كذلك؟ نعم، يمكن لأمر Get-Help العثور على محتوى المساعدة حول نفسه.
استخدم أمر Get-Help بانتظام عند البحث عن معلومات إضافية حول أوامر PowerShell. لا داعي للذهاب إلى جوجل عندما يكون لديك نظام مساعدة قوي وأمر لمساعدتك في الاستفادة منه.