התקנת מודול Exchange Online PowerShell (שלב אחר שלב)

By Mirko Peters · 2026-11-12

התקנת מודול Exchange Online PowerShell באמצעות Install-Module ExchangeOnlineManagement: דרישות מוקדמות, היקף ההתקנה, בדיקת גרסה, עדכונים ותיקון שגיאות.

Automatically translated with AI from the original post. Read the English original

כדי להתקין את מודול Exchange Online PowerShell, פתחו את PowerShell כמנהל מערכת והריצו Install-Module -Name ExchangeOnlineManagement. הפקודה מתקינה את המודול לכלל המשתמשים במחשב. אם אינכם יכולים להריץ אותה כמנהל מערכת, הוסיפו -Scope CurrentUser, וההתקנה תתבצע לחשבון שלכם בלבד. מאמר זה מיועד למנהלי Exchange ו-Microsoft 365 שמקימים מחשב ניהול חדש, שרת קפיצה (jump server) או סוכן בנייה. המאמר מכסה את הדרישות המוקדמות, שלבי ההתקנה והאימות, עדכון המודול והסרתו, והשגיאות הנפוצות ביותר.

עיקרי הדברים

• התקינו את מודול Exchange Online PowerShell באמצעות Install-Module -Name ExchangeOnlineManagement, בחלון PowerShell שנפתח כמנהל מערכת, לכלל המשתמשים.
• השתמשו ב-Scope CurrentUser אם אין לכם הרשאות מנהל. עדכנו את המודול מאוחר יותר עם אותו Scope שבו התקנתם אותו.
• Windows PowerShell 5.1 דורש את .NET Framework 4.7.2. התמיכה ב-PowerShell 7 תלויה בגרסת המודול, ובגרסה 3.10.0 ומעלה נדרש PowerShell 7.6.0.
• בדקו את התוצאה באמצעות Get-InstalledModule, שמציג את הגרסה ואת המיקום של המודול: לכלל המשתמשים או למשתמש הנוכחי.
• המודול כבר אינו דורש אימות Basic ב-WinRM, מאחר שהחיבורים שלו מבוססים על REST.

מה המודול ומה נדרש לפני ההתקנה

המודול נקרא ExchangeOnlineManagement. בתיעוד של Microsoft הוא מכונה מודול Exchange Online PowerShell V3. באמצעותו מתחברים ל-Exchange Online PowerShell, ל-Security & Compliance PowerShell ול-PowerShell עבור תוסף האבטחה המובנה לתיבות דואר מקומיות. המודול משתמש באימות מודרני, ולכן הוא פועל עם אימות רב-שלבי ובלעדיו.

יש שינוי אחד שמשפיע על סקריפטים ישנים. לפי Microsoft, מאז אוקטובר 2023 חיבורי REST API החליפו את חיבורי ה-remote PowerShell הישנים שהתבססו על אימות Basic. חיבורי המודול אינם דורשים אימות Basic ב-WinRM, ולכן אין שם מה להפעיל.

לפני ההתקנה, בדקו את הדרישות המוקדמות הבאות:

• גרסת PowerShell ו-.NET. Windows PowerShell 5.1 דורש את .NET Framework 4.7.2. ב-Windows 11, Windows Server 2022 ו-Windows Server 2025 מותקנת הגרסה 4.8.x, ולכן הדרישה מתקיימת. PowerShell 7 נתמך גם הוא, והגרסה המינימלית תלויה בגרסת המודול, כפי שמוסבר בסעיף הבא.
• מדיניות הרצת סקריפטים (Execution Policy). לפי הדף של Microsoft, ללא מדיניות הרצה מתאימה תופיע השגיאה "Files cannot be loaded because running scripts is disabled on this system". התיקון המתועד הוא Set-ExecutionPolicy RemoteSigned, שמורץ כמנהל מערכת. לפני שתשנו את ההגדרה, קראו את הדף של Microsoft על מדיניות הרצה, ואם המחשב מנוהל, בררו קודם עם צוות האבטחה שלכם.
• PowerShellGet ו-PackageManagement. חיבורי REST ב-Windows דורשים את PowerShellGet, וכן PowerShellGet תלוי ב-PackageManagement. בלעדיהם ייתכן שתראו שגיאה על חסרון של הפקודה Update-ModuleManifest. מיקרוסופט גם מציינת שגרסאות preview של שני המודולים האלה עלולות לגרום לבעיות התחברות, ומספקת פקודה להצגת הגרסאות המותקנות: Get-InstalledModule PackageManagement -AllVersions; Get-InstalledModule PowerShellGet -AllVersions.
• TLS 1.2. ב-Windows PowerShell 5.1 בגרסה ישנה יותר של Windows, ה-PowerShell Gallery דורשת TLS 1.2 ומעלה. אם ההורדה נכשלת עם שגיאת התחברות בשרת ישן, זה הדבר הראשון שכדאי לבדוק.

מערכת ישנה מאוד היא מבוי סתום. Windows 7 SP1 ו-Windows Server 2008 R2 SP1 מקבלים רק גרסת מודול 2.0.3, ומיקרוסופט מציינת שגרסה זו אינה יכולה להתחבר משום שאין בה תמיכה ב-REST.

איזו גרסת PowerShell מתאימה לאיזו גרסת מודול

Windows PowerShell 5.1 עובד עם כל גרסאות המודול, בכפוף לדרישת ה-.NET שלמעלה. עבור PowerShell 7, מיקרוסופט מציגה את המיפוי הבא:

• מודול בגרסה 3.10.0 ומעלה דורש PowerShell 7.6.0 ומעלה, שמשתמש ב-.NET 10.
• מודולים בגרסאות 3.5.0 עד 3.9.2 דורשים PowerShell 7.4.0 ומעלה, שמשתמש ב-.NET 8.
• מודולים בגרסאות 3.0.0 עד 3.4.0 דורשים PowerShell 7.2.0 ומעלה, שמשתמש ב-.NET 6.
• מודול בגרסה 2.0.4 ומעלה בקו 2.x דורש PowerShell 7.0.3.

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

מיקרוסופט תומכת במודול גם ב-Linux וב-macOS. ב-Linux, התחברות דרך proxy דורשת גרסת מודול 3.0.0 ומעלה. בשתי המערכות, Connect-IPPSSession, וכתוצאה מכך גם Security & Compliance PowerShell, אינם זמינים ב-PowerShell 7. אם אתם מנהלים את Exchange Online ממחשב Mac, זו המגבלה היחידה שכדאי להכיר לפני שמתכננים את כלי העבודה שלכם.

Windows 10 ראוי להערה קצרה. מהדורות הצרכנים הגיעו לסוף התמיכה באוקטובר 2025, ומיקרוסופט מציינת שהן אינן תומכות ב-.NET 8.0 או ב-.NET 10.0. עבור מודול 3.5.0 ומעלה עם PowerShell 7.4 ומעלה, פועלות רק מהדורות Enterprise ו-IoT LTSC שעדיין נמצאות בתמיכה.

בדקו את גרסת PowerShell לפני ההתקנה

בדיקה של שתי דקות חוסכת הרבה ניחושים בהמשך. בחלון שבו תעבדו, הריצו את $PSVersionTable.PSVersion כדי לראות באיזו גרסה של PowerShell אתם משתמשים. השוו את התוצאה למיפוי שלמעלה. ב-Windows PowerShell 5.1 כדאי גם לדעת את גרסת PowerShellGet, ולכן הריצו Get-InstalledModule PowerShellGet -AllVersions. אם הפקודה מציגה גרסת preview, הסירו אותה או עדכנו לגרסה יציבה לפני שממשיכים. עמוד המודול של מיקרוסופט מציין גרסאות preview של PowerShellGet ו-PackageManagement כמקור לבעיות התחברות.

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

שלבי התקנה של מודול Exchange Online PowerShell

השלבים האלה פועלים ב-Windows PowerShell 5.1 וב-PowerShell 7.

1. פתחו את PowerShell. בחרו Run as administrator אם תרצו להתקין עבור כל המשתמשים. דלגו על כך אם אתם מתכננים להתקין רק עבור המשתמש הנוכחי.
2. אם זהו המודול הראשון שאתם מתקינים במחשב, עדכנו קודם את PowerShellGet, ולאחר מכן סגרו ופתחו מחדש את PowerShell. מיקרוסופט ממליצה על סדר פעולות זה לפני ההתקנה הראשונה.
3. הריצו Install-Module -Name ExchangeOnlineManagement עבור כל המשתמשים. עבור החשבון שלכם בלבד, הריצו Install-Module -Name ExchangeOnlineManagement -Scope CurrentUser.
4. ענו על כל הנחיה ש-PowerShell מציג במהלך ההתקנה. הארגון שלכם חייב לאפשר גישה ל-PowerShell Gallery כדי שההורדה תצליח.
5. אמתו את ההתקנה באמצעות Get-InstalledModule ExchangeOnlineManagement | Format-List Name,Version,InstalledLocation.
6. קראו את השורה InstalledLocation. נתיב תחת %ProgramFiles%\WindowsPowerShell\Modules\ מעיד שהמודול מותקן עבור כל המשתמשים. נתיב בתיקיית Documents שלכם מעיד שהמודול מותקן עבור המשתמש הנוכחי בלבד.
7. בדקו זאת בחלון חדש עם Connect-ExchangeOnline -UserPrincipalName admin@contoso.com. לפרטי החיבור, ראו המאמר Connect to Exchange Online PowerShell.

רוצים גרסת תצוגה מקדימה? הוסיפו -AllowPrerelease. כדי לבחור גרסת תצוגה מקדימה מסוימת, שלבו אותו עם -RequiredVersion. Find-Module ExchangeOnlineManagement -AllVersions -AllowPrerelease מציג את הגרסאות הזמינות, ואם משמיטים את -AllowPrerelease מוצגות רק הגרסאות הציבוריות. אל תתקינו גרסת תצוגה מקדימה בשרת ניהול פרודקשן ללא סיבה מוצדקת. בדקו קודם במחשב חלופי.

עדכון והסרה של המודול

Microsoft מפרסמת גרסאות חדשות של המודול באופן קבוע, ונוטות השחרור בדף המודול מפרטות מה השתנה. לדוגמה, בגרסה 3.7.0 עזרת שורת הפקודה כבר אינה נטענת כברירת מחדל, ובגרסה 3.9.2 הפרמטר UseRpsSession הוצא משימוש. העדכון נעשה בשורה אחת: Update-Module -Name ExchangeOnlineManagement. להתקנה למשתמש הנוכחי הוסיפו -Scope CurrentUser. לפי Microsoft, יש להשתמש באותו Scope שבו בוצעה ההתקנה. אי-התאמה עלולה להשאיר התקנה בשני המיקומים, ואז לא תהיה תשובה ברורה לשאלה באיזו מהן PowerShell משתמש.

לכן כדאי מאוד להריץ את הבדיקה Get-InstalledModule משלב 5 לפני עדכון ואחריו. אם מופיעות שתי גרסאות, בדקו לאיזה Scope שייך כל אחת מהן.

להסרת המודול, הריצו Uninstall-Module -Name ExchangeOnlineManagement. אם המודול הותקן לכל המשתמשים, בצעו זאת כמנהל מערכת. לאחר מכן סגרו את חלונות PowerShell הפתוחים, כי מודול שכבר נטען נשאר בזיכרון עד לסיום ה-session שלו.

פתרון שגיאות התקנה נפוצות

דף המודול של Microsoft מפרט כמה שגיאות ספציפיות ואת הפתרונות להן.

• "No match was found for the specified search criteria and module name 'ExchangeOnlineManagement'". הריצו Register-PSRepository -Default, שירשום מחדש את PowerShell Gallery כמאגר. לאחר מכן נסו שוב את ההתקנה.
• שגיאות על PowerShellGetFormatVersion, או על חוסר יכולת להוריד providers. עדכנו את PowerShellGet והפעילו מחדש את PowerShell.
• ההורדה נכשלת במחשב עם Windows PowerShell 5.1 ישן. ה-PowerShell Gallery דורש TLS 1.2 או גרסה מתקדמת יותר. Microsoft מקשרת לפוסט בלוג על התמיכה ב-TLS של הגלריה לפרטים נוספים.
• "Files cannot be loaded because running scripts is disabled on this system". הגדירו את מדיניות ההרצה כמתואר לעיל, כמנהל מערכת.
• "Cannot find a cmdlet Update-Manifest" או הודעה דומה על Update-ModuleManifest בעת החיבור. חסר PowerShellGet או PackageManagement. התקינו את שניהם והפעילו מחדש את PowerShell.

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

טעויות נפוצות

• ערבוב Scopes. התקנה לכל המשתמשים ולאחר מכן עדכון עם -Scope CurrentUser משאירים על המחשב שתי גרסאות. בחרו Scope אחד ושמרו עליו.
• הרצת גרסת PowerShell שאינה מתאימה למודול. המודול החדש ביותר עם PowerShell 7 ישן יותר נכשל בדרכים שנראות כמו שגיאות חיבור. השוו את הגרסאות שלכם לטבלה שלמעלה.
• התקנת גרסת תצוגה מקדימה על שרת פרודקשן. גרסאות תצוגה מקדימה מיועדות לבדיקות. לעבודה היומיומית השתמשו בגרסה הציבורית.
• התעלמות מ-PowerShellGet. PowerShellGet חסר או בגרסת תצוגה מקדימה עלול לשבור חיבורי REST, כפי שמתואר בדף של Microsoft. בדקו אותו קודם כאשר התקנה חדשה אינה מתחברת.
• פעילות לפי מדריכים ישנים. מדריכים שמורים להפעיל Basic authentication ב-WinRM מתארים את שיטת remote PowerShell שכבר יצאה משימוש. אינכם זקוקים לה.

נושאים קשורים לעיון

• התחברות עם המודול: לאחר ההתקנה, השאלה הבאה היא כיצד להתחבר, עם MFA או בלעדיו. המאמר על מודול Exchange Online PowerShell ועל מאמר החיבור הנלווה אליו עוסקים בכך, דרך Exchange Online PowerShell module.
• אימות App-only: סקריפטים מתוזמנים זקוקים לתעודה או ל-managed identity, ולא לסיסמה שמוקלדת.
• שימוש במודול ב-PowerShell 7 ב-Linux וב-macOS: הגרסאות הנתמכות משתנות לפי מערכת ההפעלה, לכן בדקו קודם את רשימת התאימות.
• שליטה במי יכול להשתמש ב-PowerShell: מנהל Exchange יכול לאפשר או לחסום גישה ל-Exchange Online PowerShell לכל משתמש בנפרד.
• שמירה על עדכניות המודולים: הגדירו תזכורת קבועה לבדיקת גרסאות חדשות של המודול, מכיוון ש-Microsoft מעלה מדי פעם את גרסת PowerShell המינימלית הנדרשת.

הצעד הבא

כדי להתקין את מודול Exchange Online PowerShell, הריצו Install-Module -Name ExchangeOnlineManagement, אמתו את ההתקנה עם Get-InstalledModule, ושמרו על אותו היקף (scope) בכל עדכון עתידי. לאחר מכן התחברו עם Connect-ExchangeOnline בחלון חדש, והריצו Get-AcceptedDomain כדי לוודא שההגדרה עובדת.