שימוש Show-Command ו- Get-Help ב- PowerShell

  • 10 דקות

הcmdlet הצגת פקודות פותח חלון המציג רשימת פקודות או פרמטרים של פקודה ספציפית. חלון זה זהה לזה שיוצג בעת בחירת האפשרות הצגפקודה ב- ISE.

כדי להציג פרמטרים של פקודה ספציפית, ספק את שם הפקודה כערך עבור הפרמטר -name הפרמטר. לדוגמה, כדי לפתוח את הצג אתCommand Window עם הפקודה המשמשת לאחזור משתמש Active Directory, הזן את הפקודה הבאה במסוף ולאחר מכן הקש על מקש Enter:

Show-Command –Name Get-ADUser

הפרמטר -name הוא positional, כך שהפקודה הבאה מפיקה את אותה תוצאה:

Show-Command Get-ADUser

אם תבחר באפשרות הצג אתCommand Window ב- ISE, והסמן נמצא בתוך או מיד ליד שם פקודה בתוך המסוף או חלונית ה- Scripting, התוצאות זהות.

הערה

בדוגמאות אלה, Show-Command היא הפקודה שאתה מפעיל בפועל, אך Get-ADUser הוא שם הפקודה שברצונך לסקור בתיבת הדו-שיח.

בתוך הכרטיסיה הצגפקודות, כל ערכת פרמטרים עבור הפקודה שצוינה מוצגת בכרטיסיה נפרדת. פעולה זו מ להבהיר באופן חזותי שלא ניתן לשלב ולתאם פרמטרים בין ערכות.

לאחר שתספק ערכים עבור כל הפרמטרים הנדרשים, תוכל להפעיל את הפקודה באופן מיידי על-ידי בחירת הפעל בחלון הצג פקודות. באפשרותך גם להעתיק אותו ללוח על-ידי בחירה באפשרות העתק. מהלוח, באפשרותך להדביק את הפקודה במסוף, כך שתוכל לסקור את תחביר שורת הפקודה הנכון מבלי להפעיל את הפקודה.

שים לב ש- Show-Command חושף גם את הפרמטרים הנפוצים של Windows PowerShell , שהם קבוצה של פרמטרים ש- Windows PowerShell מוסיף לכל הפקודות כדי לספק ערכה מוגדרת מראש של יכולות ליבה. תקבל מידע נוסף על רבים מהפרמטרים הנפוצים במודולים הקרובים. עם זאת, אם ברצונך לקבל פרטים אודותיהם כעת, הפעל את לעזור לך about_common_parameters- Windows PowerShell ועיין בתוצאות.

שימוש Get-Help

Windows PowerShell מספק עזרה נרחבת בתוך המוצר עבור פקודות. באפשרותך לגשת לעזרה זו באמצעות Get-Help שלך. האפליקציה 'קבלת' מציגה את כל תוכן העזרה על המסך ומאפשרת לך לגלול לאורך המסך. באפשרותך גם להשתמש העזרה או בכינוי Man, הממפה לפקודה Get-help. כל שלוש ההחזרים בעיקרון אותן תוצאות. תוצאות אלה כוללות תיאור קצר והארוך של ה- cmdlet, התחביר, הערות נוספות ממחבר העזרה וקישורים לרכיבי cmdlet קשורים או למידע נוסף באינטרנט. הפקודות לעזור וMan מציגות תוכן בקונסולה דף אחד בכל פעם. ISE מציג את תוכן העזרה כולו.

לדוגמה, כדי להציג את פרטי העזרה עבור Get-ChildItem cmdlet, הזן את הפקודה הבאה במסוף ולאחר מכן הקש על מקש Enter:

Get-Help Get-ChildItem

Get-Help פרמטרים

הפקודה קבלת עזרה מקבלת פרמטרים המאפשרים לך למצוא מידע נוסף מעבר למידע המוצג כברירת מחדל. סיבה נפוצה לבקשת עזרה נוספת היא לזהות דוגמאות שימוש עבור פקודה. פקודות Windows PowerShell כוללות בדרך כלל דוגמאות רבות כאלה. לדוגמה, הפעלת הפקודה Get-Help Stop-Process – יספקו דוגמאות לשימוש ב- cmdlet Stop-Process cmdlet.

הפרמטר -full מספק מידע מעמיק אודות cmdlet, כולל:

  • תיאור של כל פרמטר.
  • אם לכל פרמטר יש ערך ברירת מחדל (למרות שמידע זה אינו תועד באופן עקבי בכל הפקודות).
  • אם פרמטר הוא הכרחי.
  • אם פרמטר יכול לקבל ערך במיקום ספציפי (במקרה זה, מספר המיקום, החל מ- 1, נתון) או אם עליך להזין את שם הפרמטר (במקרה זה, בשם מוצג).
  • אם פרמטר מקבל קלט צינור ואם כן, כיצד.

פרמטרים קבלת-עזרה כוללים:

  • -ShowWindow. הצגת נושא העזרה בחלון נפרד, כך שיהיה קל הרבה יותר לגשת לעזרה בעת הזנת פקודות.
  • -מקוון. הצגת הגירסה המקוונת של נושא העזרה (בדרך up-toביותר - תאריך) בחלון דפדפן.
  • -ParameterName. הצגת התיאור של פרמטר בעל שם.
  • -Category. הצגת עזרה רק עבור קטגוריות מסוימות של פקודות, כגון רכיבי cmdlet ופונקציות.

שימוש Get-Help לחיפוש פקודות

הפקודה קבלת-עזרה יכולה להיות שימושית מאוד לאיתור פקודות. הוא מקבל תווים כלליים (*, ?), ומציין את התו הכללי כוכבית (*). כאשר תבקש עזרה ותשתמש בתווים כלליים עם שם פקודה חלקי, Windows PowerShell יציג רשימה של נושאי עזרה תואמים.

על-ידי שימוש במידע שלמדת קודם לכן על מבנה שם הפועל של רכיבי cmdlet, באפשרותך להשתמש ב- Get-Help ככלי כדי לגלות רכיבי cmdlet גם אם אינך יודע את שמותיהם. לדוגמה, אם אתה מעוניין בכל רכיבי ה- cmdlet הפועלים על תהליכים, באפשרותך להזין את הפקודה Get-Help *process* בקונסולה ולאחר מכן להקיש על מקש Enter. התוצאות תואמות לתוצאות שהוחזרו על-ידי Get-Command *process*, למעט העובדה Get-Help מציג של. סינדיקט זה הוא תיאור קצר שמסייע לך לזהות את הפקודה הרצויה.

לעתים, ייתכן שתציין חיפוש כללי שאינו תואם לשם פקודה כלשהו. לדוגמה, הפעלת Get-Help *beep* לא תמצא פקודות beep מופיעות בשם שלהן. כאשר לא נמצאו תוצאות, מערכת העזרה מבצעת חיפוש טקסט מלא של תיאורי פקודות זמינים וסנופות זמינות. חיפוש זה מאתר את כל קבצי העזרה המכילים את beep. אם יש רק קובץ יחיד עם התאמה, מערכת העזרה מציגה את התוכן שלה, במקום להציג רשימה של פריט אחד. במקרה של מונח החיפוש beep, Get-Help מחזיר רשימה של שני נושאים: Set-PSReadlineOption, cmdlet ו- about_Special_Characters, נושא עזרה מושגי.