عينات بوويرشيل إينتوني

page_type	منتجات	اللغات	ملحقات	noDependeency
عينة	مللي الرسم البياني	com.powershell	نوع المحتوى التقنيات خدمات تاريخ الإنشاء عينات مايكروسوفت الرسم البياني يرنم 4/4/2017 9:41:27 صباحًا	حقيقي

مهم

أعلنا في العام الماضي عن مستودع Microsoft Intune GitHub الجديد هنا استنادًا إلى وحدة PowerShell المستندة إلى Microsoft Graph SDK. أصبح مستودع GitHub لنماذج البرامج النصية القديمة هذا من Microsoft Intune PowerShell الآن للقراءة فقط. بالإضافة إلى ذلك، بدءًا من 1 أبريل 2024، نظرًا لأساليب المصادقة المحدثة في وحدة PowerShell المستندة إلى Graph SDK، ستتم إزالة طريقة المصادقة المستندة إلى معرف تطبيق (العميل) Microsoft Intune PowerShell العالمي.

كيف سيؤثر ذلك على مؤسستك

إذا كنت تستخدم معرف تطبيق Intune PowerShell (d1ddf0e4-d672-4dae-b554-9d5bdfd93547)، فستحتاج إلى تحديث البرامج النصية الخاصة بك باستخدام معرف التطبيق المسجل لمعرف Microsoft Entra لمنع البرامج النصية الخاصة بك من التعطل.

ما عليك القيام به للتحضير

قبل 6 مايو 2024، قم بتحديث البرامج النصية لـ PowerShell عن طريق:

1. إنشاء تسجيل تطبيق جديد في مركز إدارة Microsoft Entra. للحصول على تعليمات مفصلة، ​​اقرأ: البدء السريع: قم بتسجيل تطبيق باستخدام النظام الأساسي لهوية Microsoft.
2. قم بتحديث البرامج النصية التي تحتوي على معرف تطبيق Intune (d1ddf0e4-d672-4dae-b554-9d5bdfd93547) باستخدام معرف التطبيق الجديد الذي تم إنشاؤه في الخطوة 1.

قم بمراجعة ملف "تحديث تسجيل التطبيق" للحصول على تعليمات مفصلة. (https://github.com/microsoftgraph/powershell-intune-samples/blob/master/Updating%20App%20Registration)

عينات الرسم البياني Intune

يوضح مستودع نماذج البرامج النصية لـ PowerShell كيفية الوصول إلى موارد خدمة Intune. لقد قاموا بتوضيح ذلك عن طريق تقديم طلبات HTTPS RESTful API إلى Microsoft Graph API من PowerShell.

يمكن العثور على وثائق Intune وMicrosoft Graph هنا وثائق Intune Graph.

توضح هذه العينات الإجراءات النموذجية لمسؤول Intune أو شريك Microsoft لإدارة موارد Intune.

يتم تضمين العينات التالية في هذا المستودع:

• موافقة المشرف
• AndroidEnterprise
• تسجيل أبل
• التطبيقات
• مزامنة التطبيقات
• سياسة حماية التطبيق
• التدقيق
• المصادقة
• هيئة التصديق
• التحقق من الحالة
• بوابة الشركة العلامة التجارية
• سياسة الامتثال
• تسجيل جهاز الشركة
• تكوين الجهاز
• قيود التسجيل
• IntuneDataExport
• LOB_Application
• الأجهزة المُدارة
• الترحيل
• RBAC
• RemoteActionAudit
• تحديثات البرامج
• الشروط والأحكام
• تقرير سياسة المستخدم

البرامج النصية مرخصة "كما هي". تحت رخصة معهد ماساتشوستس للتكنولوجيا.

تنصل

تقوم بعض نماذج البرامج النصية باسترداد المعلومات من مستأجر Intune الخاص بك، والبعض الآخر يقوم بإنشاء البيانات أو حذفها أو تحديثها في مستأجر Intune الخاص بك. فهم تأثير كل نموذج نصي قبل تشغيله؛ يجب تشغيل العينات باستخدام حساب مستأجر غير إنتاجي أو "اختباري".

استخدام واجهة برمجة تطبيقات Intune Graph

تتيح واجهة برمجة تطبيقات Intune Graph إمكانية الوصول إلى معلومات Intune برمجيًا للمستأجر الخاص بك، وتنفذ واجهة برمجة التطبيقات نفس عمليات Intune كتلك المتوفرة من خلال Azure Portal.

يوفر Intune البيانات في Microsoft Graph بنفس الطريقة التي تتبعها الخدمات السحابية الأخرى، مع معلومات الكيان الغنية والتنقل بين العلاقات. استخدم Microsoft Graph لدمج المعلومات من الخدمات الأخرى وIntune لإنشاء تطبيقات غنية عبر الخدمات لمحترفي تكنولوجيا المعلومات أو المستخدمين النهائيين.

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

يتطلب استخدام نماذج Microsoft Graph API Intune PowerShell ما يلي:

• قم بتثبيت وحدة AzureAD PowerShell عن طريق تشغيل "Install-Module AzureAD" أو "Install-Module AzureADPreview" من موجه PowerShell مرتفع
• مستأجر Intune الذي يدعم مدخل Azure بترخيص إنتاج أو إصدار تجريبي (https://docs.microsoft.com/en-us/intune-azure/introduction/what-is-microsoft-intune)
• يتطلب استخدام واجهات برمجة تطبيقات Microsoft Graph لتكوين عناصر تحكم وسياسات Intune ترخيص Intune.
• حساب يتمتع بأذونات لإدارة خدمة Intune
• PowerShell v5.0 على نظام التشغيل Windows 10 x64 (يعد PowerShell v4.0 الحد الأدنى من المتطلبات لكي تعمل البرامج النصية بشكل صحيح)
• ملاحظة: بالنسبة إلى PowerShell 4.0، ستحتاج إلى وحدة PowershellGet لـ PS 4.0 لتمكين استخدام وظيفة تثبيت الوحدة النمطية
• يتطلب استخدام هذه البرامج النصية لأول مرة أن يقبل المسؤول العام للمستأجر أذونات التطبيق

ابدء

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

1. استخدام البرنامج النصي

1. قم بتنزيل محتويات المستودع على جهاز Windows المحلي الخاص بك

• قم باستخراج الملفات إلى مجلد محلي (على سبيل المثال، C:IntuneGraphSamples)
• قم بتشغيل PowerShell x64 من قائمة البداية
• استعرض للوصول إلى الدليل (على سبيل المثال cd C:IntuneGraphSamples)
• بالنسبة لكل مجلد في المستودع المحلي، يمكنك التصفح للوصول إلى هذا الدليل ثم تشغيل البرنامج النصي الذي تختاره
• مثال لاستخدام البرنامج النصي للتطبيق:
  • لاستخدام البرامج النصية لإدارة التطبيقات، من C:IntuneGraphSamples، قم بتشغيل "cd .Applications"
  • بمجرد الدخول إلى المجلد، قم بتشغيل .Application_MDM_Get.ps1 للحصول على كافة التطبيقات المضافة لـ MDM ويمكن استخدام تسلسل الخطوات هذا لكل مجلد....

2. المصادقة باستخدام Microsoft Graph

في المرة الأولى التي تقوم فيها بتشغيل هذه البرامج النصية، سيُطلب منك تقديم حساب للمصادقة مع الخدمة:

 Please specify your user principal name for Azure Authentication:

بمجرد تقديم اسم المستخدم الرئيسي، سيتم فتح نافذة منبثقة تطالبك بكلمة المرور الخاصة بك. بعد المصادقة الناجحة مع Azure Active Directory، سيستمر رمز المستخدم المميز لمدة ساعة، وبمجرد انتهاء الساعة خلال جلسة PowerShell سيُطلب منك إعادة المصادقة.

إذا كنت تقوم بتشغيل البرنامج النصي لأول مرة ضد المستأجر الخاص بك، فسيتم عرض نافذة منبثقة تنص على:

 Microsoft Intune PowerShell needs permission to:

* Sign you in and read your profile
* Read all groups
* Read directory data
* Read and write Microsoft Intune Device Configuration and Policies (preview)
* Read and write Microsoft Intune RBAC settings (preview)
* Perform user-impacting remote actions on Microsoft Intune devices (preview)
* Sign in as you
* Read and write Microsoft Intune devices (preview)
* Read and write all groups
* Read and write Microsoft Intune configuration (preview)
* Read and write Microsoft Intune apps (preview)

ملاحظة: إذا كان حساب المستخدم الخاص بك مستهدفًا للوصول المشروط المستند إلى الجهاز، فيجب أن يكون جهازك مسجلاً أو متوافقًا لتمرير المصادقة.

المساهمة

إذا كنت ترغب في المساهمة في هذه العينة، راجع CONTRIBUTING.MD.

اعتمد هذا المشروع قواعد السلوك الخاصة بشركة Microsoft مفتوحة المصدر. لمزيد من المعلومات، راجع الأسئلة الشائعة حول قواعد السلوك أو اتصل بـ [email protected] لطرح أي أسئلة أو تعليقات إضافية.

الأسئلة والتعليقات

نود أن نحصل على تعليقاتك حول نموذج Intune PowerShell. يمكنك إرسال أسئلتك واقتراحاتك إلينا في قسم المشكلات في هذا المستودع.

ملاحظاتك مهمة بالنسبة لنا. تواصل معنا على Stack Overflow. ضع علامة على أسئلتك باستخدام [MicrosoftGraph] و[intune].

موارد إضافية

• وثائق Microsoft Graph API
• بوابة الرسم البياني لمايكروسوفت
• نماذج التعليمات البرمجية لمايكروسوفت
• توثيق الرسم البياني Intune

حقوق الطبع والنشر

حقوق الطبع والنشر (ج) 2017 لشركة مايكروسوفت. جميع الحقوق محفوظة.

اعتمد هذا المشروع قواعد السلوك الخاصة بشركة Microsoft مفتوحة المصدر. لمزيد من المعلومات، راجع الأسئلة الشائعة حول قواعد السلوك أو اتصل بـ [email protected] لطرح أي أسئلة أو تعليقات إضافية.