السابق

التالي

اكتشاف الأمر باستخدام نظام التعليمات

مكتمل

باستخدام نظام التعليمات المضمّن في PowerShell، يمكنك معرفة المزيد حول أمر معين. يمكنك استخدام Get-Command cmdlet لتحديد موقع أمر تحتاجه. بعد تحديد موقع الأمر، قد ترغب في معرفة المزيد حول ما يفعله الأمر والطرق المختلفة لتسميته.

اكتشاف أوامر cmdlets باستخدام نظام التعليمات والحصول على التعليمات

يمكنك استخدام Get-Help cmdlet الأساسي لمعرفة المزيد حول الأمر. عادةً ما تقوم باستدعاء Get-Help عن طريق تحديده بالاسم وإضافة علامة -Name التي تحتوي على اسم cmdlet الذي تريد التعرف عليه. إليك مثال:

Get-Help -Name Get-Help

تحديث التعليمات

لا تتضمن الإصدارات الجديدة من PowerShell نظام المساعدة افتراضيًا. في المرة الأولى التي تقوم فيها بتشغيل Get-Help، سيُطلب منك تثبيت ملفات التعليمات. يمكنك أيضًا تشغيل Update-Help cmdlet لتثبيت ملفات التعليمات. نظرًا إلى أن الاتصال بـ Update-Help يقوم بتنزيل العديد من ملفات المساعدة، يمكن أن يجلب الأمر مرة واحدة فقط يوميًا بشكل افتراضي. يمكنك تجاوز سلوك الإحضار هذا باستخدام العلامة -Force.

تقوم بتحديث ملفات التعليمات بشكل مختلف على Windows مقارنة بـ Linux أو macOS. تختلف العملية لأنه عند تشغيل الأمر Update-Help cmdlet، يتم جلب ملفات التعليمات عبر الإنترنت من خلال مطابقة ثقافة الكمبيوتر. على Windows، تم تثبيت الثقافة بالفعل، لكنها مفقودة في Linux وmacOS. لذلك تحتاج إلى تحديد ثقافة عند تحديث ملفات المساعدة على Linux وmacOS.

إليك مثالاً على الأمر:

Update-Help -UICulture en-US -Verbose

يحدد هذا الأمر العلامة -UICulture. حيث يعطيه القيمة en-US، التي تجلب ملفات التعليمات باللغة الإنجليزية الأمريكية. لتحديث ملفات التعليمات على macOS أو Linux، استخدم ثقافة تتوافق مع ثقافة جهازك.

استكشاف أقسام التعليمات

عند استدعاء Get-Help على cmdlet يتم إرجاع صفحة تعليمات. تتضمن الصفحة العديد من الأقسام. من المحتمل أن ترى هذه الأقسام الشائعة:

• NAME: يوفر اسم الأمر.
• SYNTAX: يعرض طرقًا لاستدعاء الأمر باستخدام مجموعة من العلامات والمعلمات المسموح بها في بعض الأحيان.
• ALIASES: يسرد أية أسماء مستعارة للأمر. الاسم المستعار هو اسم مختلف للأمر، ويمكن استخدامه لاستدعاء الأمر.
• REMARKS: يوفر معلومات حول الأوامر التي يجب تشغيلها للحصول على مزيد من المساعدة لهذا الأمر.
• PARAMETERS: يوفر تفاصيل حول المعلمة. يسرد نوعها ووصفًا أطول وقيمًا مقبولة، إن أمكن.

تصفية استجابة التعليمات

إذا كنت لا ترغب في عرض صفحة التعليمات الكاملة، يمكنك تضييق نطاق الاستجابة عن طريق إضافة علامات إلى الأمر Get-Help. فيما يلي بعض العلامات التي يمكنك استخدامها:

• Full: يُرجع صفحة تعليمات مفصلة. يحدد معلومات مثل المعلمات والمدخلات والمخرجات التي لا تحصل عليها في الاستجابة القياسية.
• Detailed: يُرجع استجابة تبدو مثل الاستجابة القياسية، ولكنها تتضمن قسمًا للمعلمات.
• Examples: يُرجع الأمثلة فقط، إن وجدت.
• Online: يفتح صفحة ويب لأمرك.
• Parameter: يتطلب اسم معلمة كوسيطة. وهو يسرد خصائص معلمة معينة.

على سبيل المثال، يمكنك استخدام الأمر التالي لإرجاع القسم «Examples» فقط من صفحة التعليمات.

Get-Help Get-FileHash -Examples

تحسين تجربة القراءة

يؤدي إرجاع Get-Help إلى عرض صفحة التعليمات بالكامل. قد لا توفر الصفحة أفضل تجربة قراءة. قد تحتاج إلى التمرير للعثور على القسم الذي تريد قراءته. الأسلوب الأفضل هو استخدام اسم help المستعار. ينقل اسم help المستعار Get-Help إلى وظيفة تضمن أن الإخراج يمكن قراءته سطرًا تلو الآخر. كما أنه يجعل الاستجابة قابلة للقراءة صفحة تلو الأخرى، من خلال ترقيم صفحات النتائج. ستستخدم الاسم المستعار help في الوحدة التالية.

متابعة