تثبيت 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 على نفس الكمبيوتر في نفس الوقت.
حول معرض PowerShell
يتم توزيع الوحدة Azure AD باستخدام معرض PowerShell. يتطلب تثبيت العناصر من المعرض أحدث إصدار من وحدة PowerShellGet، المتوفرة في Windows 10 أو في إطار عمل إدارة Windows (WMF) 5.0 أو في المثبت المستند إلى MSI (ل PowerShell 3 و4).
باستخدام أحدث وحدة PowerShellGet ، يمكنك:
- البحث عن العناصر في المعرض باستخدام Find-Module و Find-Script
- حفظ العناصر في النظام الخاص بك من المعرض باستخدام Save-Module و Save-Script
- تثبيت عناصر من المعرض باستخدام Install-Module و Install-Script
- تحميل العناصر إلى المعرض باستخدام Publish-Module و Publish-Script
- إضافة مستودع مخصص خاص بك باستخدام Register-PSRepository
راجع صفحة بدء الاستخدام لمزيد من المعلومات حول كيفية استخدام أوامر 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 لمزيد من المعلومات.
الخطوات التالية
الملاحظات
https://aka.ms/ContentUserFeedback.
قريبًا: خلال عام 2024، سنتخلص تدريجيًا من GitHub Issues بوصفها آلية إرسال ملاحظات للمحتوى ونستبدلها بنظام ملاحظات جديد. لمزيد من المعلومات، راجعإرسال الملاحظات وعرضها المتعلقة بـ