התחברות ל-SharePoint Online עם PnP PowerShell: אפשרויות כניסה
By Mirko Peters · · Updated
התחברות ל-SharePoint Online עם PnP PowerShell: רשמו אפליקציה משלכם ב-Entra, ואז בחרו כניסה אינטראקטיבית, במכשיר, באמצעות אישור או זהות מנוהלת לכל משימה.
Automatically translated with AI from the original post. Read the English original
כדי להתחבר היום ל-SharePoint Online עם PnP PowerShell, רושמים פעם אחת אפליקציה משלכם ב-Microsoft Entra ID. לאחר מכן קוראים ל-Connect-PnPOnline עם כתובת האתר ועם מזהה הלקוח של האפליקציה, בתוספת שיטת כניסה אחת: אינטראקטיבית, כניסה במכשיר, אישור, זהות מנוהלת או אישורים מדור קודם. המדריך מיועד למנהלי SharePoint שמריצים סקריפטים ידנית או לפי תזמון. הוא מסביר מה עושה כל אפשרות, מתי להשתמש בה, ואילו טעויות מפילות חיבור. הוא גם מראה איך לבחור אפשרות אחת לכל משימה, כך שסקריפט לא יקבל יותר גישה ממה שהמשימה דורשת.
עיקרי הדברים
- החל מ-9 בספטמבר 2024, Connect-PnPOnline דורש -ClientId, ולכן כל מנהל חייב קודם לרשום אפליקציה ב-Microsoft Entra ID שהמודול יכול להיכנס באמצעותה.
- כניסה אינטראקטיבית היא הבחירה הנכונה לאדם שיושב מול המקלדת, מכיוון שהיא תומכת באימות מרובד ואינה דורשת סוד שמור.
- משימות ללא השגחה צריכות להשתמש בכניסה באמצעות אישור או בזהות מנוהלת, ולא בסיסמה שמוקלדת ידנית ולא בסוד לקוח השמור בתוך סקריפט.
- שיטת סוד הלקוח מדור קודם פועלת רק עבור cmdlets של SharePoint, ולכן כל פקודה שקוראת ל-Microsoft Graph תיכשל איתה.
- רשמו את האפליקציה עם הרשאות מואצלות בלבד שאתם צריכים, מכיוון שהרישום ברירת המחדל מבקש הרשאות רחבות כמו AllSites.FullControl.
תחילת העבודה: מדוע כל חיבור דורש אפליקציה משלכם
PnP PowerShell הוא מודול שמתוחזק על ידי הקהילה. אין לו הרשאות מיוחדות משלו. כל כניסה עוברת דרך רישום אפליקציה ב-Microsoft Entra, והאפליקציה הזו קובעת מה הסקריפט רשאי לעשות.
עיון ב-Connect-PnPOnline קובע שמאז 9 בספטמבר 2024 יש לספק את הפרמטר -ClientId. הוא גם קובע שיש לרשום קודם אפליקציה משלכם. במקום להקליד את המזהה בכל פעם, אפשר להגדיר את משתנה הסביבה ENTRAID_APP_ID או ENTRAID_CLIENT_ID.
שינוי זה משפיע על סקריפטים ישנים. אם סקריפט מ-2023 קורא ל-Connect-PnPOnline -Url ... -Interactive ולא מעבר לכך, כעת הוא ייכשל או יבקש מזהה לקוח חסר. התיקון אינו נמצא בלוגיקה של הסקריפט. צריך אפליקציה ומזהה.
יש עוד שני ערכים שמופיעים בכל הדוגמאות:
-Urlהיא כתובת האתר שברצונכם לעבוד עליו, למשלhttps://contoso.sharepoint.com/sites/finance. הוא נדרש ברוב השיטות.-Tenantהוא שם הדייר, למשלcontoso.onmicrosoft.com. העיון מציין שהוא נדרש בשיטות אישור ו-thumbprint. בכניסה אינטראקטיבית ובכניסה במכשיר הוא אופציונלי.
אם פקודה דורשת את מרכז הניהול של SharePoint, אפשר להעביר את -TenantAdminUrl. אם משמיטים אותו, ה-cmdlets מניחים את הצורה https://[tenantname]-admin.sharepoint.com במקום שבו זה רלוונטי.
שלב 1: השלמת רישום האפליקציה ב-Microsoft Entra
שלב ההתחלה הזה מניח שמודול PnP.PowerShell כבר מותקן במחשב שלך. ל-PnP יש עזר להגדרה הראשונית. דף הפקודה של Register-PnPEntraIDAppForInteractiveLogin מציג את הצורה הקצרה ביותר:
Register-PnPEntraIDAppForInteractiveLogin -ApplicationName TestApp -Tenant yourtenant.onmicrosoft.com
חלון דפדפן ייפתח כדי שתוכל/תוכלו להיכנס, והפקודה תיצור את האפליקציה. היא גם תציג את מזהה האפליקציה, שבו תשתמשו בתור -ClientId. הוסיפו -DeviceLogin אם אינכם יכולים לפתוח דפדפן במחשב. לפי הדף, זה מעביר את הכניסה לזרימת התחברות באמצעות מכשיר, שתומכת באימות רב-שלבי.
שימו לב להרשאות. בדוגמה הפשוטה, האפליקציה מבקשת לקבל הסכמה להרשאות מואצלות (delegated) הבאות: AllSites.FullControl, Group.ReadWrite.All, User.ReadWrite.All ו-TermStore.ReadWrite.All. הדוגמה השנייה באותו דף מצמצמת זאת עם -GraphDelegatePermissions "Group.Read.All" ו--SharePointDelegatePermissions "AllSites.FullControl".
זה חשוב לעיקרון ההרשאות המינימליות. סקריפט דיווח שרק קורא לא צריך הרשאות כתיבה על משתמשים וקבוצות. החליטו מה הסקריפטים שלכם צריכים, ובקשו רק את זה.
שמרו רישום של כל רישום אפליקציה: השם, מזהה הלקוח (client ID), הבעלים וההרשאות שיש לו. בדקו את רישום האפליקציה פעם בשנה, ומחקו אותו כשאף סקריפט כבר לא משתמש בו.
שתי מגבלות שכדאי להכיר. דף הפניה אינו מציין איזה תפקיד ב-Entra נדרש לרישום אפליקציה, ולכן כדאי לשאול את מנהל הזהויות שלכם לפני שמתחילים. בנוסף, הפרמטר -SignInAudience קובע אילו סוגי חשבונות האפליקציה תומכת בהם, ולכן יש לוודא שהוא תואם לדייר שלכם.
איך מתחברים ל-SharePoint Online באמצעות PnP PowerShell: חמש האפשרויות
כל חמש הדוגמאות מבוססות על דף הפניה של Connect-PnPOnline. החליפו את הערכים שבתוך סוגריים משולשים.
כניסה אינטראקטיבית
Connect-PnPOnline -Url "https://contoso.sharepoint.com" -Interactive -ClientId <appId>
זו ברירת המחדל למשתמש אנושי. לפי הדף, השיטה נועדה לתמוך באימות רב-שלבי. הוסיפו -ForceAuthentication כדי לנקות את פרטי האימות השמורים ולהיכנס עם חשבון אחר. השתמשו בזה כשאתם עוברים בין דייר בדיקות לדייר ייצור.
כניסה באמצעות מכשיר
Connect-PnPOnline -Url "https://contoso.sharepoint.com" -DeviceLogin -ClientId <appId>
דפדפן ייפתח והקוד יועתק ללוח שלכם. בחרו בשיטה הזו כשה-shell פועל בסשן מרוחק שבו חלון אינטראקטיבי אינו עובד היטב.
כניסה באמצעות אישור (אפליקציה בלבד)
Connect-PnPOnline -Url "https://contoso.sharepoint.com" -ClientId <appId> -Tenant 'contoso.onmicrosoft.com' -Thumbprint <thumbprint>
אף אדם לא נכנס. האפליקציה פועלת באופן עצמאי, עם הרשאות האפליקציה שהענקתם לה. אפשר להעביר את -CertificatePath יחד עם -CertificatePassword, ערך של -CertificateBase64Encoded, או -Thumbprint. שיטת טביעת האצבע (thumbprint) דורשת שהאישור יימצא במאגר האישורים של Windows. זו הבחירה הסטנדרטית לסקריפטים ללא השגחה על שרת.
זהות מנוהלת
Connect-PnPOnline -Url "https://contoso.sharepoint.com" -ManagedIdentity
לפי הדף, השיטה פועלת רק בסביבות שתומכות בזהויות מנוהלות, כמו Azure Functions, runbooks של Automation ו-Cloud Shell. אינכם שומרים שום סוד בכלל. לזהות שמוקצית על ידי משתמש, הוסיפו אחד מ--UserAssignedManagedIdentityClientId, -UserAssignedManagedIdentityObjectId או -UserAssignedManagedIdentityAzureResourceId. הפרמטר -Url אופציונלי בשיטה הזו.
פרטי זיהוי וסודות לקוח
נותרו עוד שתי שיטות ישנות, ולשתיהן יש אזהרות.
-Credentialsמקבל PSCredential, למשל(Get-Credential), או את שמו של Generic Credential ב-Windows Credential Manager. הדף מציין תמיכה באימות רב-שלבי בכניסה אינטראקטיבית ובכניסה באמצעות מכשיר, אבל אינו טוען זאת כאן. התייחסו לזה כאפשרות לחשבונות ללא הנחיה, ובדקו לפני שאתם נשענים על כך.-ClientSecretעם-ClientIdהיא שיטת ה-ACS הישנה. בתיעוד נכתב שבאמצעותה "רק cmdlets שמתחברים ל-SharePoint Online יעבדו". cmdlets שמשתמשים ב-Microsoft Graph ייכשלו.
הימנעו משתי השיטות בכל דבר חדש. סיסמה בתוך סקריפט היא סיכון, וסוד לקוח (client secret) פג תוקף ללא אזהרה.
דוגמה: בחירת אפשרות כניסה לארבע משימות
המספרים והשמות שלהלן בדויים ונועדו להמחשה בלבד.
צוות מנהלים בחברה בדיונית מריץ ארבע משימות. הוא רוצה אפליקציה אחת לכל רמת סיכון, ולא אפליקציה אחת לכל הדברים.
- בדיקות מזדמנות שמבצע מנהל מהמחשב הנייד. השתמשו ב-
-Interactiveעם אפליקציה שיש לה הרשאות מואצלות צרות. המנהל נכנס עם MFA. שום דבר לא נשמר. - ריצה חד-פעמית לניקוי בשרת קפיצה מרוחק. השתמשו ב-
-DeviceLogin. המנהל מסיים את הכניסה בטלפון או במחשב הנייד, והריצה מתחילה. - מלאי לילי בשרת Windows. השתמשו בתעודה עם
-Thumbprint. לאפליקציה יש הרשאות יישום לקריאה בלבד. התעודה תקפה 12 חודשים, והצוות מזין את תאריך החידוש ביומן משותף. - משימה שבועית ב-Runbook של Automation. השתמשו ב-
-ManagedIdentity. אין תעודה או סוד שצריך לחדש.
התוצאה: רק משימה 1 ומשימה 2 תלויות באדם. משימות 3 ו-4 רצות ללא נוכחות של איש, ואף אחת מהן לא שומרת סיסמה. אם השרת של משימה 3 יגנב, הצוות מבטל תעודה אחת. אין צורך לאפס סיסמת מנהל.
לא משנה באיזו אפשרות תבחרו, שמרו את כתובת האתר במשתנה כמו $siteUrl, כך שסקריפט PowerShell אחד יוכל לעבור על כל אתר ברשימת אתרים, לשלוף מכל אתר SharePoint את הנתונים הנדרשים ולהעלות דוח. בדקו את הסקריפט על אוסף אתרים אחד לפני שתריצו אותו על כל הדייר של Microsoft 365.
טעויות נפוצות
- שכחה של
-ClientId. החיבור ייכשל או יבקש את המזהה. שמרו את המזהה במשתנה הסביבהENTRAID_APP_IDבמכונות שבהן אתם מריצים סקריפטים לעיתים קרובות. - שימוש באפליקציה אחת רבת-עוצמה לכל דבר. הרישום הברירת מחדל מבקש את AllSites.FullControl והרשאת כתיבה למשתמשים ולקבוצות. רשמו אפליקציה שנייה, לקריאה בלבד, לדוחות.
- שימוש בסוד לקוח עם cmdlets מבוססי Graph. השיטה הישנה עובדת רק עם cmdlets של SharePoint. אם פקודה קוראת ל-Graph, היא תיכשל, והודעת השגיאה עלולה להיות מבלבלת.
- הכנסת סיסמה או סוד לקובץ הסקריפט. כל מי שיש לו הרשאת קריאה לקובץ מחזיק בפרטי ההזדהות. השתמשו במאגר תעודות או בזהות מנוהלת.
- אי בדיקת הכניסה בסביבה הסופית. סקריפט שעובד במחשב הנייד עם
-Interactiveעלול להיכשל בשרת ללא דפדפן. בדקו עם השיטה שבה המשימה תשתמש בפועל. - הישארות מחוברים לדייר הלא נכון. השתמשו ב-
-ForceAuthenticationכשאתם מחליפים חשבון, והדפיסו את פרטי החיבור בתחילת כל סקריפט.
איך תוכנה יכולה לעזור
התחילו ממה שכבר יש לכם. מודול PnP ו-Microsoft Graph PowerShell SDK מכסים את רוב סקריפטי הניהול. Azure Automation מריץ סקריפטים לפי לוח זמנים עם זהות מנוהלת, ומרכז הניהול של SharePoint מציג אתרים והגדרות ללא קוד. לסודות, מאגר תעודות או Key Vault בטוחים יותר מקובץ סקריפט.
הוסיפו דיווח מעל הכול. סקריפט שמתחבר נכון הוא רק הצעד הראשון. הצוותים צריכים גם יומן ברור של מה שכל סקריפט שינה ואיזו זהות אפליקציה הוא השתמש בה, כדי שהמנהל הבא יוכל לעקוב אחריו. שמרו את היומן במקום שכולם יכולים לקרוא, כמו רשימה משותפת או מערכת קריאות.
הצעד הבא
רשמו היום אפליקציה אחת עם המערך הקטן ביותר של הרשאות מואצלות שהסקריפטים שלכם צריכים. לאחר מכן בדקו שאתם יכולים להתחבר ל-SharePoint Online עם PnP PowerShell באמצעות -Interactive, וכתבו לעצמכם איזו אפשרות כניסה תשתמש בה כל אחת מהמשימות המתוזמנות שלכם.