M365Con 2027 – כנס אונליין חינמי · 11–22 Jan 2027 · 120 sessions→ m365con.net

בלוג · Mirko Peters

המודולים של Exchange Online ו-Microsoft Graph נכשלים יחד ב-Runbook אחד ב-Azure Automation

By ·

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

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

Runbook בדיקה מתחבר ל-Exchange Online באמצעות הזהות המנוהלת שלו וקורא תיבת דואר. הוא עובד. Runbook בדיקה שני מתחבר ל-Microsoft Graph עם אותה זהות וקורא משתמש. גם הוא עובד. כאשר מכניסים את שניהם לאותו Runbook, הוא נכשל.

עיקרי הדברים

  • השגיאות הן כשלי טעינת מודולים, לא שגיאות הרשאה. הענקת הרשאות נוספות לא תפתור אותן.
  • תיקון קהילתי מאושר מ-2024 זיהה את הסיבה: שני המודולים טוענים לתוך תהליך אחד גרסאות שונות של System.Text.Json, והמודול שנטען ראשון הוא המנצח.
  • שרשור ממרץ 2026 עקף את הבעיה באמצעות סביבת זמן ריצה חדשה של PowerShell 7.4 ו-ExchangeOnlineManagement 3.5.0, אך השואל עדיין לא בדק את הסקריפט האמיתי.
  • Learn מציין ש-ExchangeOnlineManagement 3.10.0 ומעלה דורש PowerShell 7.6, ואילו דף סביבת זמן הריצה של Automation מציג את 5.1 ו-7.4. נעלו את גרסת המודול ובדקו בחלונית ה-Test לפני הפרסום.

זהו שרשור Microsoft Q&A ממרץ 2026, שממנו מתחיל מאמר זה. הוא תואם שרשור קודם ב-Tech Community מ-2024, שהגיע לפתרון שאושר על ידי השואל שלו. מאמר זה מסביר את הסיבה, מציג מה Microsoft Learn אומר על גרסאות וסביבות זמן ריצה, ומספק תוכנית בדיקה. זהו מדריך לפתרון תקלות, ואינו נוהל רשמי של Microsoft.

סימפטומים

השואל ממרץ 2026 השתמש בזהות מנוהלת שהוקצתה על ידי המערכת, עם Connect-ExchangeOnline -ManagedIdentity -Organization <tenant>.onmicrosoft.com ולאחריה Connect-MgGraph -Identity. יובאו גרסה 3.9.2 של ExchangeOnlineManagement וכמה מודולים של Microsoft.Graph. השגיאות היו:

  • זמן ריצה 5.1: Connect-MgGraph נמצא במודול Microsoft.Graph.Authentication, אך לא ניתן היה לטעון את המודול.
  • זמן ריצה 7.2: Unable to find type [Microsoft.Exchange.Management.RestApiClient.ExchangeEnvironment].

השרשור מ-2024, שהתרחש במחשב שולחני עם Windows PowerShell 5.1, הציג את IDX12729: Unable to decode the header ... as Base64Url encoded string ושגיאת "method not found" שציינה את System.Text.Json.Utf8JsonReader. מפרסם אחר בשרשור זה ראה את Connect-MgGraph: Invalid JWT access token כאשר נעשה שימוש ב-Connect-IPPSSession באותו סשן.

כל השגיאות האלה הן שגיאות טעינה או זמן ריצה. אין כאן הודעות Authorization_RequestDenied או הודעות גישה נדחתה. ההבדל הזה חשוב, כי תשובה שנוצרה על ידי AI בשרשור מרץ הנחתה את השואל להעניק את Exchange.ManageAsApp ואת התפקיד Exchange Administrator. אלה דרישות מוקדמות אמיתיות, אבל הן עוסקות בהרשאות ולא יתקנו מודול שאינו נטען.

למה זה קורה

בשרשור מ-2024 סומנה כפתרון תשובה של חבר קהילה (Silver Contributor, לא עובד של Microsoft). היא טענה ששני המודולים טוענים עותק משלהם של System.Text.Json.dll לאותו תהליך PowerShell. Exchange Online 3.5.1 נשלח עם גרסה 8.0.x, ו-Microsoft.Graph.Authentication משתמש בגרסה 6.0.x. PowerShell שומר רק גרסה אחת של אסמבלי לכל תהליך, ולכן המודול שנטען ראשון גובר, והשני עלול להיכשל.

השואל באותו שרשור הסיר את מודולי Graph לפני החיבור, עדכן את שני המודולים וניקה את מטמון MSAL. שום דבר מזה לא עזר. לאחר שחזר ל-ExchangeOnlineManagement 3.4.0, השואל כתב שזה עבד. מפרסמים אחרים דיווחו על אותו תיקון. מפרסם נוסף דיווח על שיפור עם 3.6.0, אבל Connect-IPPSSession מבוסס תעודה עדיין נכשל אצלו. מפרסם אחד דיווח שהגדרת -LogLevel ל-Default במקום All תיקנה את הבעיה בבדיקה שלו. Learn אינו מזכיר הגדרה זו, לכן יש להתייחס אליה כדיווח מהקהילה בלבד.

מנחה מתנדב (MVP) בשרשור מ-2026 נתן הסבר דומה. המודולים תלויים בקבצי בינאריים נוספים שאינם מיושרים בין הצוותים, ולכן ייתכן שתצטרכו לשלב גרסאות מודולים ומארחי PowerShell שונים.

Learn אינו מתאר את הקונפליקט של System.Text.Json. עם זאת, בהערות הגרסה של ExchangeOnlineManagement 3.6.0 מופיע הפריט "Added fix for compatibility issue with the Microsoft.Graph module", ללא כל פירוט נוסף.

שלב 1: אבחנו איזה סוג שגיאה יש לכם

  1. הריצו כל חיבור בנפרד ב-runbook לבדיקה. אם שניהם פועלים לבד, מדובר בהתנגשות ולא בבעיית הרשאות.
  2. העתיקו את שורת השגיאה הראשונה. כל מה שקשור לטעינת מודול, טיפוס או מתודה הוא התנגשות. Forbidden, Access denied או Authorization_RequestDenied הם בעיית הרשאות.
  3. לבעיות הרשאות, פעלו לפי דף הזהות המנוהלת של Learn עבור Exchange. נדרשת הקצאת הרשאת API של Exchange.ManageAsApp לזהות, ותפקיד Entra כמו Exchange Administrator. לפי הערת Learn, לתפקיד Security Administrator אין את ההרשאות הנדרשות למשימות אלה.

שלב 2: בדקו איזו גרסת אסמבלי כל מודול דורש

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

``powershell (Get-Item -Path "$([System.Text.Json.Utf8JsonReader].Assembly.Location)").VersionInfo ``

חזרו על הפעולה בסשן חדש עם המודול השני. אם הגרסאות שונות, יש לכם את ההתנגשות מאותו שרשור. השתמשו באותן גרסאות מודולים כמו ב-runbook.

שלב 3: נעצו גרסאות בסביבת זמן ריצה נפרדת

המשתמש ממרץ 2026 פתר את מקרה הבדיקה על ידי בניית סביבת זמן ריצה חדשה. השרשור אינו מפרט את הלחיצות. דף סביבת זמן הריצה של Learn כן מפרט אותן:

  1. בפורטל Azure, פתחו את חשבון ה-Automation. בסקירה כללית (Overview), בחרו ב-Try Runtime Environment experience אם אינכם נמצאים בו כבר.
  2. תחת Process Automation, בחרו ב-Runtime Environments, ואז ב-Create.
  3. בלשונית Basics, הזינו שם, בחרו PowerShell כשפה ו-7.4 כגרסת זמן הריצה. לפי Learn, לא ניתן לשנות את השפה והגרסה לאחר מכן.
  4. בלשונית Packages, חבילת Az נוספת כברירת מחדל. השתמשו ב-Add from gallery כדי להוסיף את ExchangeOnlineManagement בגרסה נעוצה ואת מודולי Microsoft.Graph שאתם קוראים להם. השרשור השתמש בגרסה 3.5.0 עבור Exchange Online.
  5. בחרו יצירה.
  6. קשרו עותק של ה-runbook שלכם. תחת Runbooks, בחרו בו, ואז ב-Update Runtime Environment.
  7. פתחו את ה-runbook, בחרו Edit in Portal, בחרו את הסביבה החדשה, ואז Test pane ו-Start. פרסמו רק אם הבדיקה עברה.

Learn מציין שייבוא חבילה עשוי להימשך כמה דקות, שאפשר להוסיף עד 10 חבילות בכל פעם, ושבחוויה החדשה, חלונית ה-Modules מוחלפת בסביבות זמן ריצה (runtime environments).

הגרסה שכדאי לנעול תלויה בזמן הריצה:

  • Learn מציין ש-ExchangeOnlineManagement בגרסה 3.10.0 ומעלה דורשת PowerShell בגרסה 7.6.0 ומעלה, בשל תלויות של רכיבי .NET 10. עמוד זמני הריצה שלו מציין את 5.1 ואת 7.4 כאפשרויות. לכן, זמן ריצה 7.4 דורש גרסה ישנה מ-3.10.0. זו מסקנה שנגזרת משני עמודי Learn ואינה קביעה של אף אחד מהם, לכן כדאי לוודא מה החשבון שלכם מציע בפועל.
  • Learn מונה בעיות עבור הגרסאות 3.7.0 עד 3.9.2 ב-Ubuntu 20.04 ו-18.04, ומציין את 3.9.2 כגרסה האחרונה עבור כמה פלטפורמות ישנות יותר. ההערות האלה מתייחסות לפלטפורמות שולחן עבודה ולא ל-Automation.
  • הבדיקה שבשרשור ממרץ השתמשה בגרסה 3.5.0 על 7.4. השואל הוסיף תגובה שלפיה הסקריפט האמיתי עדיין לא נבדק, ולכן אין תשובה מאושרת לגבי 3.9.x על 7.4.
  • זמן ריצה 5.1 לא מנע את ההתנגשות בשרשור ממרץ, שנכשל על 5.1 עם 3.9.2.

בדקו לפחות שני שילובים, למשל את גרסת Exchange שנעלתם לצד מודולי Graph העדכניים ביותר, ולצד גרסת Graph ישנה יותר. Learn מזהיר שגרסאות preview של PackageManagement או PowerShellGet עלולות לגרום לבעיות חיבור, לכן השתמשו בגרסאות המשוחררות.

שלב 4: שקלו לפצל את העבודה

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

בדקו גם אם אפשר להחליף בGraph את פקודות Exchange בסקריפט שלכם. עמוד Exchange של Learn מציין זאת לגבי ארבע פקודות של קבוצות Microsoft 365, כמו New-UnifiedGroup, שלדבריו אינן ניתנות לשימוש עם managed identity, וממליץ לעבור ל-Graph. במשימות אחרות, אל תניחו של-Graph יש תחליף שווה ערך.

אימות

  1. בחלונית Test, הפלט של ה-job מציג את שני החיבורים ותוצאה אחת משתי השירותים.
  2. הריצו את ה-runbook שפורסם דרך תזמון או הפעלה ידנית, ובדקו בזרמי ה-job אזהרות על טעינת רכיבי assembly.
  3. רשמו את גרסאות המודולים המדויקות ואת זמן הריצה. עדכון עתידי בגלריה עלול לשבור הגדרה שעבדה. הנעילה מגנה עליכם רק כל עוד לא משנים את הגרסאות.

מגבלות

  • שרשור 2024 ישן מהחלון הרגיל והשתמש ב-PowerShell של Windows בגרסת שולחן עבודה. הוא נכלל כי הוא מציין את הסיבה ויש לו תוצאה מאושרת.
  • הפתרון בשרשור 2026 הוא בדיקה ראשונה, ואינו תיקון מאומת לסביבת ייצור.
  • עמוד managed identity של Exchange ב-Learn עדיין מזכיר את זמני הריצה 5.1 ו-7.1 (Preview) בעת הוספת המודול, וזה שונה מעמוד זמני הריצה. לזמני הריצה העדכניים, השתמשו בעמוד runtime environment.
  • Learn אינו מתעד את ההתנגשות עצמה. ההסבר לסיבה מגיע ממומחה מהקהילה.

קישורים קשורים

מקורות

Entities in this article

Azure Automation Exchange Online PowerShell Microsoft Graph PowerShell Managed identity

Related articles

RSS