مشاركة عبر

تثبيت Azure Active Directory PowerShell for Graph

  • مقالة

هام

Azure AD من المقرر إهمال Powershell في 30 مارس 2024. لمزيد من التفاصيل حول خطط الإهمال، راجع تحديث الإهمال. نحن نشجعك على متابعة الترحيل إلى Microsoft Graph PowerShell، وهي الوحدة الموصى بها للتفاعل مع Azure AD. بالإضافة إلى ذلك، يسمح لك Microsoft Graph PowerShell بالوصول إلى جميع واجهات برمجة تطبيقات Microsoft Graph وهو متوفر على PowerShell 7. للحصول على إجابات لاستعلامات الترحيل المتكررة، راجع الأسئلة المتداولة حول الترحيل.

يمكنك استخدام إصدار الوحدة النمطية Azure Active Directory PowerShell ل Graph Azure AD المهام الإدارية مثل إدارة المستخدم وإدارة المجال وتكوين تسجيل الدخول الأحادي. تختلف أوامر cmdlets المدرجة هنا عن أوامر cmdlets MSOnline التي تعد جزءا من الإصدار 1.0 من Azure Active Directory PowerShell.

تحتوي الوحدة النمطية Azure AD PowerShell for Graph على إصدارين: إصدار المعاينة العامة وإصدار التوفر العام (GA). لا يوصى باستخدام الإصدار الأولي لسيناريوهات الإنتاج.

قم بتنزيل الوحدات النمطية من معرض PowerShell استخدم ما يلي؛

محفوظات إصدار Azure Active Directory PowerShell for Graph

محفوظات الإصدار للوحدة النمطية Azure AD والوحدة النمطية Azure AD Preview هنا:azure active Directory powershell للرسم البياني: محفوظات إصدار الإصدار.

تثبيت الوحدة النمطية Azure AD

المتطلبات الأساسية

يتم دعم وحدة Azure AD على أنظمة تشغيل Windows التالية مع الإصدار الافتراضي من Microsoft .NET Framework Windows PowerShell:

  • Windows 8.1
  • Windows 8
  • Windows 7
  • Windows Server 2012 R2،
  • Windows Server 2012
  • Windows Server 2008 R2.

ملاحظة

الوحدة النمطية Azure AD PowerShell غير متوافقة مع PowerShell 7. وهو مدعوم فقط في PowerShell 5.1.

لتثبيت إصدار التوفر العام للوحدة النمطية، قم بتشغيل:

Install-Module AzureAD

لتثبيت إصدار المعاينة العامة، قم بتشغيل:

Install-module AzureADPreview

لا يمكنك تثبيت كل من إصدار المعاينة وإصدار GA على نفس الكمبيوتر في نفس الوقت.

يتم توزيع الوحدة Azure AD باستخدام معرض PowerShell. يتطلب تثبيت العناصر من المعرض أحدث إصدار من وحدة PowerShellGet، المتوفرة في Windows 10 أو في إطار عمل إدارة Windows (WMF) 5.0 أو في المثبت المستند إلى MSI (ل PowerShell 3 و4).

باستخدام أحدث وحدة PowerShellGet ، يمكنك:

راجع صفحة بدء الاستخدام لمزيد من المعلومات حول كيفية استخدام أوامر PowerShellGet مع المعرض. يمكنك أيضا تشغيل Update-Help -Module PowerShellGet لتثبيت التعليمات المحلية لهذه الأوامر.

أنظمة التشغيل المدعومة

تتطلب وحدة PowerShellGetPowerShell 3.0 أو أحدث.

لذلك، يتطلب PowerShellGet أحد أنظمة التشغيل التالية:

  • Windows 10
  • Windows 8.1 Pro
  • Windows 8.1 Enterprise
  • Windows 7 SP1
  • Windows Server 2016 TP5
  • Windows Server 2012 R2
  • Windows Server 2008 R2 SP1

يتطلب PowerShellGet أيضا .NET Framework 4.5 أو أعلى. يمكنك تثبيت .NET Framework 4.5 أو أعلى من هنا.

تحديث الوحدة النمطية Azure AD

للتحقق من إصدار الوحدة النمطية المثبتة على الكمبيوتر، قم بتشغيل هذا الأمر:

Get-Module AzureADPreview

ModuleType Version Name                ExportedCommands
---------- ------- ----                ----------------
Binary     2.0.0.7 azureadpreview     {Add-AzureADAdmini...

لتحديث إصدار وحدة PowerShell Azure AD على جهاز الكمبيوتر الخاص بك، أعد تشغيل cmdlet Install-Module:

Install-Module AzureADPreview

يتحقق هذا الأمر من معرض PowerShell لمعرفة ما إذا كان هناك إصدار أحدث متوفرا. إذا كانت الإجابة بنعم، فإن الأحدث من تلك المثبتة على جهاز الكمبيوتر الخاص بك.

الاتصال بـ Azure AD

قبل أن تتمكن من تشغيل أي من أوامر cmdlets التي تمت مناقشتها في هذه المقالة، يجب عليك أولا الاتصال بالخدمة عبر الإنترنت. للقيام بذلك، قم بتشغيل cmdlet Connect-AzureAD في موجه الأوامر Windows PowerShell. ستتم مطالبتك بعد ذلك ببيانات الاعتماد الخاصة بك. إذا أردت، يمكنك توفير بيانات الاعتماد مسبقا، على سبيل المثال:

$AzureAdCred = Get-Credential
Connect-AzureAD -Credential $AzureAdCred

يطالب الأمر الأول ببيانات الاعتماد ويخزنها ك $AzureAdCred. يستخدم الأمر التالي بيانات الاعتماد هذه ك $azureadcred للاتصال بالخدمة.

ملاحظة

تتكون وحدات Azure AD ومعاينة Azure AD من أوامر cmdlets مع اصطلاحات تسمية مختلفة، أي -AzureAD و-AzureADMS. -AzureAD تتصل أوامر cmdlets بنقطة https://graph.windows.net نهاية Azure AD Graph بينما -AzureADMS تقوم أوامر cmdlets بإجراء مكالمات إلى نقطة graph.microsoft.comنهاية Microsoft Graph . تتم معالجة المصادقة بصمت عند تغيير المكالمات من نقطة نهاية إلى أخرى ولا تتم مطالبتك ببيانات الاعتماد مرة أخرى.

للاتصال ببيئة معينة من Azure Active Directory، استخدم المعلمة AzureEnvironment ، كما يلي:

Connect-AzureAD -AzureEnvironment "AzureGermanyCloud"

يربط هذا المثال جلسة PowerShell ببيئة AzureAD الألمانية. راجع Connect-AzureAD لمزيد من المعلومات.

الخطوات التالية