كيفية استيراد وحدات Office 365 PowerShell النمطية واستخدامها

3 يونيو 2020 507 الآراء مكتب 365 بوويرشيل

يوفر Office 365 Powershell وحدات يمكنك استخدامها لأتمتة مهام Office 365. ولكن للوصول إلى هذه الوحدات النمطية ، يلزمك الاتصال بـ Office 365 Powershell.

في هذا الدليل ، سأستخدم Office 365 و O365 بالتبادل. سأستخدم أيضًا PowerShell بدلاً من PS والعكس صحيح. وغني عن القول أنك تحتاج إلى اتصال بالإنترنت لتشغيل الأوامر في هذا الدليل! ستحتاج أيضًا إلى حساب Office 365 صالح.

هذا دليل خطوة بخطوة يرشدك إلى كيفية الاتصال بـ Office 365 Powershell للوصول إلى الوحدات النمطية. يحتوي الدليل أيضًا على بعض الأمثلة على أوامر O365.

تصفح مواضيع المنشور

قم بتصدير اسم المستخدم وكلمة المرور إلى ملف XML مشفر

خطوات الحصول على وحدات Office 365 PowerShell النمطية واستخدامها - تحضير بيانات الاعتماد (تصدير ملف XML مشفر بكلمة المرور الخاصة بك)

قبل أن تتمكن من الوصول إلى Office 365 عبر PowerShell ، تحتاج إلى حساب لديه الإذن الصحيح للوصول إلى O365.

يمكنك تقديم بيانات الاعتماد مباشرة عند الاتصال بـ 365 عبر PS. ولكن ، لأغراض البرمجة النصية ، من الأفضل تصدير نسخة مشفرة من اسم المستخدم وكلمة المرور إلى ملف XML.

فيما يلي خطوات تصدير اسم المستخدم وكلمة المرور إلى ملف XML مشفر:

  • نوع بوويرشيل في شريط البحث. ثم انقر بزر الماوس الأيمن ويندوز بوويرشيل ل وحدد تشغيل كمسؤول .
مكتب 365 بوويرشيل - افتح PowerShell كمسؤول
  • في موجه PowerShell ، اكتب هذا الأمر. ثم اضغط على Enter.
powershell.exe -ExecutionPolicy Unrestricted

يؤدي هذا إلى فتح جلسة PS جديدة تسمح لك بتشغيل البرامج النصية غير الموقعة عن بُعد. بدون ذلك ، عند تشغيل الأمر الذي يستورد وحدة Office 365 PowerShell النمطية ، قد يفشل الأمر.

office 365owershell -runowershell.exe -ExecutionPolicy أمر غير مقيد
  • ثم اكتب هذا الأمر واضغط على Enter.
Get-Credential < [email protected] > | Export-CliXml -Path C:PSGet-CredentialO365loginCred.xml
يحل محل< [email protected] >باسم المستخدم O365 الخاص بك. يجب أن يكون الاسم بتنسيق UPN: [البريد الإلكتروني محمي] إذا كنت تستخدم التنسيق DomainName UserName ، فقد تفشل الأوامر اللاحقة في هذا الدليل.
  • عند تنفيذ الأمر ، سيُطلب منك إدخال كلمة مرور الحساب. أدخل كلمة المرور وانقر فوق موافق. إذا نجح الأمر ، فسيتم إنشاء ملف XML في المسار المحدد (انظر الصورة الثانية أدناه).

استيراد وحدات Office 365 PowerShell النمطية

استيراد وحدات Office 365 PowerShell النمطية

الخطوة التالية هي الاتصال بحساب O365 الخاص بك عبر PowerShell واستيراد وحدات O365 PS.

فيما يلي الخطوات:

  • لا يزال في نفس موجه أوامر PS ، اكتب هذا الأمر. ثم اضغط دخول.
$ImpCred = Import-Clixml C:PSGet-CredentialO365loginCred.xml -ErrorAction SilentlyContinue

يستورد الأمر ملف XML المشفر بكلمة المرور الخاصة بك ويخزنه في متغير يسمى $ ImpCred.

  • بعد ذلك ، قم بتنفيذ هذا الأمر ... اكتب ، ثم أدخل.
$SessionOption = New-PSSessionOption -SkipRevocationCheck -SkipCACheck -SkipCNCheck

يقوم الأمر بإنشاء SessionOption المطلوب المطلوب في الأمر التالي. ثم يخزن النتيجة في متغير SessionOption $.

في الأمر التالي ، ستقوم بإنشاء جلسة PS إلى Office 365 PowerShell.

  • هنا هو الأمر. اكتبه ثم اضغط على مفتاح الإدخال.
$Session = New-PSSession -ConfigurationName Microsoft.Exchange -ConnectionUri 'https://outlook.office365.com/powershell-liveid/' -Credential $ImpCred -Authentication Basic -AllowRedirection -SessionOption $SessionOption -WarningAction SilentlyContinue -ErrorAction SilentlyContinue
سيتأخر الأمر قليلاً - قد لا يكون بنفس سرعة الأوامر الأخرى التي ناقشناها حتى الآن.

يبدو الأمر الأخير مخيفًا وطويلًا. لكنها تؤدي مهمة بسيطة للغاية: إنها تستخدم جديد PSSession لإجراء اتصال PS عن بُعد بـ Office 365 PowerShell.

سيقوم الأمر التالي باستيراد وحدات Office 365 PowerShell النمطية إلى جلسة PS الحالية.

  • لاستيراد الجلسة التي أنشأتها إلى وحدة التحكم PS الخاصة بك ، اكتب هذا الأمر ، ثم اضغط على Enter:
Import-PSSession $Session -DisableNameChecking -AllowClobber -ErrorAction SilentlyContinue

سيستغرق الأمر بعض الوقت للتشغيل. أثناء تشغيله ، سيعرض الوحدات النمطية والأوامر التي يستوردها. عندما يتم استيراد الوحدات بالكامل ، فإنها ستعيد تفاصيل الوحدة - المميزة في الصورة الثانية أدناه.

وحدات Office 365 PowerShell النمطية متاحة الآن لتستخدمها! سيعرض القسم التالي كيفية الوصول إلى Cmdlets مع بعض الأمثلة.

تشغيل أوامر Office 365 Powershell (مع أمثلة)

تشغيل أوامر Office 365 Powershell (مع أمثلة)

الآن بعد أن قمت باستيراد وحدات O365 PS إلى جلسة PS الحالية ، يمكنك تشغيل أوامر PowerShell مباشرة على حساب Office 365 الخاص بك.

يعرض هذا القسم بعض الأمثلة.

لنبدأ بعرض جميع أوامر PS المتاحة في الوحدة المستوردة.

  • للقيام بذلك ، اكتب هذا الأمر واضغط على Enter.
Get-Command -Module tmp_ycvzopmw.1bq
استبدل tmp_ycvzopmw.1bq باسم الوحدة الموضح في الصورة الأخيرة. سيكون هذا الاسم مختلفًا في كل مرة تقوم فيها بتشغيل الأمر Import-PSSession.

نتيجة الأمر الأخير هي قائمة طويلة جدًا ...

  • للحصول على قائمة بجميع المستخدمين (وصناديق البريد) في حساب Office 365 الخاص بك ، اكتب الأمر أدناه:
تحذير!
لا تقم بتشغيل هذا الأمر في حساب إنتاج مع العديد من المستخدمين. قد يستغرق وقتا طويلا للتشغيل.
Get-User

هذه هي النتيجة التي تم إرجاعها بواسطة الأمر الخاص بحسابي في Office 365. لأسباب واضحة ، حجبت أسماء المستخدمين وصناديق البريد!

مكتب 365 بوويرشيل

كما ذكرت في تحذيري سابقًا ، لا يُنصح بتشغيل ملف الحصول على المستخدم الأمر بدون أي مرشحات.

الطريقة الموصى بها لاستخدام هذا الأمر هي إرجاع مستخدم معين أو مجموعة من المستخدمين. على سبيل المثال ، لإرجاع اسمي فقط ، سأستخدم الأمر أدناه:

Get-User -Filter 'Name -like 'Victor*''

ها هي النتيجة

مكتب 365 بوويرشيلهل تحتاج إلى مساعدة في أتمتة Office 365 و Exchange Online؟ يمكننا المساعدة في أتمتة Office 365 / Exchange / AD المختلط عبر الإنترنت فقط وفي مكان العمل والمختلط. على سبيل المثال ، يمكننا المساعدة في أتمتة عملية إنشاء صناديق بريد Exchange عبر الإنترنت لمستخدمي AD التي تم إنشاؤها في الإعلان المحلي الخاص بك. لمعرفة المزيد ، أرسل لنا متطلباتك عبر صفحة اتصل بنا.

لمعرفة المزيد عن الحصول على المستخدم cmdlet ، انقر فوق الحصول على المستخدم حلقة الوصل.

يعد العمل مع Office 365 Powershell أمرًا سهلاً للغاية! أتمنى أن أكون قد صنعت يومك.

هل لديك اي سؤال او تعليق؟ استخدم نموذج 'ترك الرد' الموجود في نهاية هذه الصفحة.

أحب هذا الدليل؟ احصل على المزيد من أدلة PS من صفحة Windows PowerShell الخاصة بنا.