התחברות ל- Microsoft 365 עם PowerShell
מאמר זה חל הן על Microsoft 365 Enterprise והן Office 365 Enterprise.
PowerShell for Microsoft 365 מאפשר לך לנהל את Microsoft 365 שלך משורת הפקודה. כדי להתחבר ל- PowerShell, פשוט התקן את התוכנה הנדרשת ולאחר מכן התחבר לארגון Microsoft 365.
קיימות שתי גירסאות של מודול PowerShell שניתן להשתמש בהן כדי להתחבר ל- Microsoft 365 ולנהל חשבונות משתמשים, קבוצות ורשיונות:
- Azure Active Directory PowerShell for Graph, שרכיבי ה- cmdlet שלו כוללים את AzureAD ב שמם
- Microsoft Azure Active Directory מודול עבור Windows PowerShell, שרכיבי ה- cmdlet שלו כוללים את Msol בשם שלהם
בשלב זה, מודול PowerShell עבור Graph של Azure Active Directory אינו מחליף לחלוטין את הפונקציונליות של מודול Microsoft Azure Active Directory עבור Windows PowerShell עבור ניהול משתמשים, קבוצות ורשיונות. במקרים מסוימים, עליך להשתמש בשתי הגירסאות. באפשרותך להתקין בבטחה את שתי הגירסאות באותו מחשב.
הערה
באפשרותך גם ליצור קשר עם Azure Cloud Shell דרך מרכז הניהול של Microsoft 365.
מה עליך לדעת לפני שתתחיל?
הערה
מודול Azure Active Directory מוחלף על-ידי ה- SDK של Microsoft Graph PowerShell. באפשרותך להשתמש ב- SDK של Microsoft Graph PowerShell כדי לגשת לכל ממשקי ה- API Microsoft Graph. לקבלת מידע נוסף, ראה תחילת העבודה עם Graph Microsoft PowerShell SDK.
מערכת הפעלה
עליך להשתמש בגירסת 64 סיביות של Windows. התמיכה בגירסת 32 הסיביות של מודול Microsoft Azure Active Directory עבור Windows PowerShell הסתיימה ב- 2014.
באפשרותך להשתמש בגירסאות הבאות של Windows:
Windows 10, Windows 8.1, Windows 8 או Windows 7 Service Pack 1 (SP1)
Windows Server 2019, Windows Server 2016, Windows Server 2012 R2, Windows Server 2012 או Windows Server 2008 R2 SP1
הערה
עבור Windows 8.1, Windows 8, Windows 7 Service Pack 1 (SP1), Windows Server 2012 R2, Windows Server 2012 ו- Windows Server 2008 R2 SP1, הורד והתקן את Windows Management Framework 5.1.
PowerShell
עבור המודול Azure Active Directory PowerShell for Graph, עליך להשתמש ב- PowerShell גירסה 5.1.
עבור מודול Microsoft Azure Active Directory עבור Windows PowerShell, עליך להשתמש ב- PowerShell גירסה 5.1 ואילך, עד ל- PowerShell גירסה 6. לא ניתן להשתמש ב- PowerShell גירסה 7.
הערה
הליכים אלה מיועדים למשתמשים החברים בתפקיד מנהל מערכת Microsoft 365. לקבלת מידע נוסף, ראה אודות תפקידי מנהל מערכת.
התחבר למודול Azure Active Directory PowerShell for Graph
פקודות במודול Azure Active Directory PowerShell עבור Graph כוללות את AzureAD בשם ה- cmdlet שלהם. באפשרותך להתקין את מודול Azure Active Directory PowerShell for Graph או Azure PowerShell.
עבור הליכים הדורשים את רכיבי ה- cmdlet החדשים במודול Azure Active Directory PowerShell for Graph, בצע שלבים אלה כדי להתקין את המודול ולחבר למנוי Microsoft 365 שלך.
הערה
לקבלת מידע אודות תמיכה בגירסאות שונות של Windows, ראה מודול Azure Active Directory PowerShell for Graph .
שלב 1: התקנת התוכנה הנדרשת
שלבים אלה נדרשים פעם אחת בלבד במחשב שלך. אך ייתכן שתצטרך לעדכן את התוכנה מעת לעת.
פתיחת Windows PowerShell שורת הפקודה.
הפעל פקודה זו:
Install-Module -Name AzureAD
כברירת מחדל, גלריית PowerShell (PSGallery) אינה מוגדרת כמאגר מהימן עבור PowerShellGet. בפעם הראשונה שתשתמש ב- PSGallery, תראה את ההודעה הבאה:
Untrusted repository
You are installing the modules from an untrusted repository. If you trust this repository, change its InstallationPolicy value by running the `Set-PSRepository` cmdlet.
Are you sure you want to install the modules from 'PSGallery'?
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "N"):
השב 'כן' או 'כן לכולם' כדי להמשיך בהתקנה.
הפעל פקודה זו כדי לייבא את המודול:
Import-Module AzureAD
שלב 2: התחברות Azure AD מנוי Microsoft 365
כדי להתחבר ל- Azure Active Directory (Azure AD) עבור מנוי Microsoft 365 שלך עם שם חשבון וסיסמה או באמצעות אימות רב-גורמי, הפעל אחת מפקודות אלה מתוך Windows PowerShell פקודה. (זה לא חייב להיות גבוה.)
| Office 365 ענן | הפקודה |
|---|---|
| Office 365 העולם (+GCC) | Connect-AzureAD |
| Office 365 על-ידי 21 Vianet | Connect-AzureAD -AzureEnvironmentName AzureChinaCloud |
| Office 365 גרמניה | Connect-AzureAD -AzureEnvironmentName AzureGermanyCloud |
| Office 365 ממשלת ארה"ב Office 365 U.S. Government GCC High | Connect-AzureAD -AzureEnvironmentName AzureUSGovernment |
בתיבת הדו-שיח היכנס לחשבון שלך, הקלד את שם המשתמש והסיסמה של חשבון Microsoft 365 בעבודה או בבית ספר ולאחר מכן בחר אישור.
אם אתה משתמש באימות רב-גורמי, בצע את ההוראות כדי לספק מידע אימות נוסף, כגון קוד אימות.
לאחר ההתחברות, באפשרותך להשתמש ברכיבי ה- cmdlet עבור מודול Azure Active Directory PowerShell for Graph.
התחבר למודול Microsoft Azure Active Directory עבור Windows PowerShell
הערה
רכיבי Cmdlet במודול Microsoft Azure Active Directory עבור Windows PowerShell כוללים את Msol בשם שלהם.
PowerShell גירסה 7 ואילך אינם תומכים במודול Microsoft Azure Active Directory עבור Windows PowerShell cmdlet עם Msol בשם שלהם. עבור PowerShell גירסה 7 ואילך, עליך להשתמש ב- SDK של Microsoft Graph PowerShell.
PowerShell Core אינו תומך במודול Microsoft Azure Active Directory עבור Windows PowerShell cmdlet עם Msol בשם שלהם. הפעל רכיבי cmdlet אלה Windows PowerShell.
שלב 1: התקנת התוכנה הנדרשת
שלבים אלה נדרשים פעם אחת בלבד במחשב שלך. אך ייתכן שתצטרך לעדכן את התוכנה מעת לעת.
אם אינך משתמש ב- Windows 10, התקן את גירסת 32 הסיביות של מסייע הכניסה של Microsoft Online Services: מסייע הכניסה של Microsoft Online Services עבור מומחי IT RTW.
בצע שלבים אלה כדי להתקין את Microsoft Azure Active Directory Module for Windows PowerShell:
- פתח שורת Windows PowerShell עם הרשאות מלאות (Windows PowerShell את שורת הפקודה כמנהל מערכת).
- הפעל את הפקודה Install-Module MSOnline .
- אם תתבקש להתקין את הספק NuGet, הקלד Y והקש Enter.
- אם תתבקש להתקין את המודול מ- PSGallery, הקלד Y והקש Enter.
שלב 2: התחברות Azure AD מנוי Microsoft 365
כדי להתחבר ל- Azure AD עבור מנוי Microsoft 365 שלך עם שם חשבון וסיסמה או באמצעות אימות רב-גורמי, הפעל אחת מפקודות אלה מתוך Windows PowerShell פקודה. (זה לא חייב להיות גבוה.)
| Office 365 ענן | הפקודה |
|---|---|
| Office 365 העולם (+GCC) | Connect-MsolService |
| Office 365 על-ידי 21 Vianet | Connect-MsolService -AzureEnvironment AzureChinaCloud |
| Office 365 גרמניה | Connect-MsolService -AzureEnvironment AzureGermanyCloud |
| Office 365 ממשלת ארה"ב Office 365 U.S. Government GCC High | Connect-MsolService -AzureEnvironment USGovernment |
בתיבת הדו-שיח היכנס לחשבון שלך, הקלד את שם המשתמש והסיסמה של חשבון Microsoft 365 בעבודה או בבית ספר ולאחר מכן בחר אישור.
אם אתה משתמש באימות רב-גורמי, בצע את ההוראות כדי לספק מידע אימות נוסף, כגון קוד אימות.
איך אתה יודע שזה עבד?
אם אינך מקבל הודעת שגיאה, התחברת בהצלחה. לבדיקה מהירה, הפעל cmdlet Microsoft 365, כגון Get-MsolUser, ובדוק את התוצאות.
אם אתה מקבל הודעת שגיאה, בדוק את הבעיות הבאות:
בעיה נפוצה היא סיסמה שגויה. הפעל שוב את שלב 2 , ולתשומת לבך, שם המשתמש והסיסמה שאתה מזין.
מודול Microsoft Azure Active Directory עבור Windows PowerShell דורש שימוש Microsoft .NET Framework 3.5. x זמין במחשב שלך. ייתכן שבמחשב שלך מותקנת גירסה חדשה יותר (לדוגמה, 4 או 4.5. x). עם זאת, תאימות לאחור עם גירסאות קודמות של .NET Framework ניתן להפוך לזמינה או ללא זמינה. לקבלת מידע נוסף, עיין במאמרים הבאים:
עבור Windows Server 2012 או Windows Server 2012 R2, ראה הפיכת .NET Framework 3.5 לזמין באמצעות אשף הוספת תפקידים ותכונות.
עבור Windows 7 או Windows Server 2008 R2, ראה לא ניתן לפתוח את מודול Azure Active Directory עבור Windows PowerShell.
לקבלת Windows 10, Windows 8.1 ו- Windows 8, ראה התקנת .NET Framework 3.5 ב- Windows 10, Windows 8.1 ו- Windows 8.
ייתכן שהגירסה של Microsoft Azure Active Directory המודול Windows PowerShell לא עדכנית. כדי לבדוק זאת, הפעל את הפקודה הבאה ב- PowerShell עבור Microsoft 365 או Microsoft Azure Active Directory Module for Windows PowerShell:
(Get-Item C:\Windows\System32\WindowsPowerShell\v1.0\Modules\MSOnline\Microsoft.Online.Administration.Automation.PSModule.dll).VersionInfo.FileVersionאם מספר הגירסה המוחזר נמוך מ- 1.0.8070.2, הסר את ההתקנה של Microsoft Azure Active Directory Module עבור Windows PowerShell והתקן אותו בשלב 1, לעיל.
אם אתה מקבל הודעת שגיאה של חיבור, ראה השגיאה "Connect-MsolService: Exception of type was thrown".
אם אתה מקבל הודעת שגיאה מסוג "Get-Item: Cannot find path", הפעל פקודה זו:
(dir "C:\Program Files\WindowsPowerShell\Modules\MSOnline").Name
צור קשר עם Azure Cloud Shell
כדי ליצור קשר עם מעטפת הענן של Azure ולהשתמש בה מתוך מרכז הניהול של Microsoft 365, בחר את סמל חלון PowerShell בפינה השמאלית העליונה של שורת המשימות. בחלונית ברוך הבא אל Azure Cloud Shell , בחר PowerShell.
תזדקק למנוי Azure פעיל עבור הארגון שלך שמקושר למנוי Microsoft 365. אם עדיין אין לך חשבון כזה, באפשרותך ליצור חשבון כזה. לאחר שיש לך מנוי Azure, ייפתח חלון PowerShell ממנו תוכל להפעיל פקודות ו- Scriptים של PowerShell.
לקבלת מידע נוסף, ראה Azure Cloud Shell.