אין cmdlets יותר מוכרים למתחילים ולמומחים כאחד מ-פקודת העזרה של PowerShell, Get-Help. בגלל מערכת העזרה המוטמעת והעדכנית של PowerShell, פקודת ה-Get-Help של PowerShell היא הדרך שבה אתה גולל מה פקודות עושות, את הפרמטרים שלהן, ואפילו (בתקווה) המון דוגמאות שימושיות כיצד להשתמש בפקודה.
כל cmdlet ופונקציה שתפגש מנועות להיות בהן תוכן עזר שנבנה עימה כי PowerShell Get-Help יכולה לקרוא. אני אומר "מנועות להיות" מאחר ולמרבה הצער, כמה מחברים לא כוללים תוכן עזר.
תוכן העזרה המשויך לפקודות ניתן למצוא על ידי הרצת Get-Help. פקודה זו קוראת גם עזרה מבוססת הערות ו- עזרה בסיסית בתצורת XML שנבנית על ידי יוצר ה-cmdlet או הפונקציה.
השימוש הנפוץ ביותר בפקודת Get-Help הוא להשתמש בה כדי למצוא תוכן עזרה עבור פקודה מסוימת. לדוגמה, אולי גילית פקודה חדשה בשם Get-Content עם פקודת Get-Command ורוצה לדעת עוד מידע עליה. תשתמש בפרמטר Name ב- Get-Help. זה יחזיר סט בסיסי של מידע על הפקודה כפי שאתה יכול לראות למטה.
תשים לב שאף על פי שמוחזרת הרבה מידע, זהו סתם סיכום של הדברים שניתן לעשות. ולעולם לא תדע ש־Get-Help יכול להחזיר גם סוגים אחרים של תוכן עזר כמו דוגמאות.
מציאת מידע על פרמטר
ניתן לחפש בעומק בתוכן העזר בכמה דרכים שונות. אחת מהדרכים הוא למצוא מידע על פרמטר יחיד של פקודה. אולי בדוגמה שאני משתמש בה כאן, אני רואה הפניה לפרמטר Raw ולא בדיוק ברור מה פרמטר זה עושה. אני יכול להשתמש בפרמטר Parameter ב־Get-Help עם הפרמטר Name כדי להחזיר רק מידע על אותו פרמטר של הפקודה הספציפית.
PowerShell Get-Help ודוגמאות
אחד הדברים הטובים ביותר במערכת העזר של PowerShell הוא שיש בה תמיכה טבעית בדוגמאות. דוגמאות הן דרך מצוינת לראות, עם הקשר, איך להשתמש בפקודה מסוימת. אם היוצר של הפקודה הוסיף דוגמאות לתוכן העזר שלו, ניתן לראות את הדוגמאות האלו על ידי השימוש בפרמטר Examples. כאשר אתה משתמש בפרמטר זה, Get-Help יחזיר דוגמא או יותר של איך להשתמש בפקודה בנסיבות שונות.
קבלת עזרה מפורטת
סיכומים, מידע על פרמטרים ודוגמאות אינם המידע היחיד שמוחזר על ידי הפקודה Get-Help של PowerShell. לפעמים, עליך לראות את כל המידע הזמין עבור cmdlet. במקרה כזה, תמיד יש לך את הפרמטרים Detailed ו־Full זמינים. כל אחד מהפרמטרים האלה מציג כמות של מידע שמתרכזת.
הפרמטר Detailed מוסיף תיאורים של פרמטרים ודוגמאות לתצוגה הראשית של העזרה. בעצם, הם משלבים שימוש בפרמטר Examples ויציגו מידע לכל הפרמטרים כאילו היית משתמש בפרמטר Parameter על כל הפרמטרים של הפקודה.
אם הפרמטר Detailed אינו מספיק; תמיד תוכל ללכת לגישה הגרעינית ולהחזיר את כל תוכן העזרה בעזרת הפרמטר Full. הפרמטר הזה אינו מסנן מידע בכלל. הפרמטר Full קורא את כל תוכן העזרה המוגדר לפקודה מסוימת.
השגת תצוגה גרפית
אם תרצה תצוגה גרפית יותר של העזרה, תוכל גם להשתמש בפרמטר ShowWindow. הפרמטר הזה מפעיל חלון שמאפשר לך לחפש בקלות בתוכן העזרה ולהציג רק אזורים מסוימים דרך הכפתור הגדרות. מבט זה מועיל אם באמת תרצה לחפש בתוכן העזרה.
סיכום
ישנם מספר פרמטרים נוספים ופחות נפוצים שתוכל להשתמש בהם עם הפקודה Get-Help של PowerShell. אם אתה מעוניין ללמוד עוד, אתה יודע איך למצוא מידע על הפרמטרים הנוספים האלה, נכון? כן, Get-Help יכול למצוא מידע על עצמו.
השתמש בפקודה Get-Help בצורה דתית כאשר אתה מחפש מידע נוסף על פקודות PowerShell. אין צורך קטן ללכת לגוגל כאשר יש לך מערכת עזרה חזקה ופקודה שתסייע לך להיכנס אליה.