كيفية إنشاء تقرير مجموعات الأدوار في Microsoft Purview باستخدام PowerShell
By Mirko Peters · · Updated
استخدم PowerShell لإنشاء تقرير بأذونات مجموعات الأدوار في Microsoft Purview. دقّق الامتثال وeDiscovery وMicrosoft 365 مع هذا الدليل.
Automatically translated with AI from the original post. Read the English original
تُعدّ إدارة مجموعات الأدوار في Purview أمرًا بالغ الأهمية للحفاظ على الأمان والامتثال داخل مؤسستك. يمكنك تبسيط هذه العملية من خلال الاستعانة بـ PowerShell، الذي يؤتمت المهام ويوفّر الوقت. باستخدام PowerShell، يمكنك بسهولة إنشاء تقرير يوضّح عضويات مجموعات الأدوار في Purview. يرشدك هذا الدليل خطوة بخطوة إلى الاتصال بـ Purview وإنشاء التقرير بفعالية.
النقاط الرئيسية
- تأكّد من أن لديك وصولًا إداريًا إلى Purview قبل إنشاء التقارير. هذا الوصول ضروري لإدارة مجموعات الأدوار بفعالية.
- ثبّت الإصدار 5.1 من PowerShell والوحدات النمطية اللازمة (CAMP وAIPService) للاتصال بـ Microsoft Purview بسلاسة.
- استخدم نصوص PowerShell لأتمتة إنشاء تقارير مجموعات الأدوار في Purview. وهذا يوفّر الوقت ويقلّل الأخطاء اليدوية.
- جدوِل تقارير منتظمة للحفاظ على الامتثال والأمان. تساعدك أتمتة هذه العملية على البقاء مطّلعًا على عضويات مجموعات الأدوار.
- حلّل بيانات التقارير لتحديد الاتجاهات والمخاطر الأمنية المحتملة. تضمن المراجعات المنتظمة أن المستخدمين المصرّح لهم فقط يملكون الوصول إلى المعلومات الحساسة.
- يمكن حصر مجموعات الأدوار في Purview وتصديرها برمجيًا: يمكنك إنشاء تقرير شامل لمجموعات أدوار Purview باستخدام PowerShell لالتقاط العضويات والأدوار المعيّنة والنطاق في تشغيل واحد.
- لا تظهر عضوية مجموعات الأدوار دائمًا في واجهة Purview: بعض العضويات المتداخلة أو الموروثة لا تظهر إلا عند الاستعلام عبر PowerShell، ما يجعل التقرير يكشف مسارات وصول خفية.
- يمكن كشف فجوات التدقيق: يمكن لتقرير مجموعات الأدوار في Purview باستخدام PowerShell أن يُظهر أذونات قديمة أو يتيمة تغفل عنها الواجهة، ما يساعد على تقليل الحسابات ذات الصلاحيات الزائدة.
- تؤثر الأدوار المخصّصة في إعداد التقارير: قد تحتوي مجموعات الأدوار التي تتضمن أدوارًا مخصّصة على مجموعات أذونات غير قياسية، ولا يحوّلها إلى صلاحيات قابلة للتنفيذ بدقة سوى تقرير مُبرمج.
- يمكن إعداد تقارير لسيناريوهات عبر المستأجرات: باستخدام أتمتة PowerShell، يمكنك دمج تقارير مجموعات الأدوار من عدة مستأجرات في عرض موحّد لمراجعات الحوكمة والامتثال.
- تتبّع التغييرات عبر الزمن ممكن: بجدولة تقارير دورية لمجموعات أدوار Purview باستخدام PowerShell وتخزين المخرجات، يمكنك تتبّع التغييرات التاريخية واكتشاف عمليات تصعيد الصلاحيات غير المتوقعة.
- التكامل مع الأدوات الأخرى سهل: يمكن تنسيق تقرير مجموعات أدوار Purview الذي ينشئه PowerShell (CSV/JSON) واستيعابه في أنظمة SIEM ومنصات GRC أو جداول البيانات للتنبيه الآلي والتحليل.
متطلبات الاستخدام المسبق لـ PowerShell

الأذونات المطلوبة
قبل أن تبدأ باستخدام PowerShell لإنشاء التقارير في Purview، تأكّد من امتلاك الأذونات اللازمة. تحتاج إلى وصول إداري إلى Purview. يتيح لك هذا الوصول عرض مجموعات الأدوار وإدارتها بفعالية. وبدون هذه الأذونات، قد تواجه أخطاء عند تنفيذ النصوص أو استرجاع البيانات.
تثبيت PowerShell
لتشغيل نصوص PowerShell، يجب أن يكون PowerShell مثبّتًا على جهازك. الحد الأدنى للإصدار المطلوب هو 5.1. وإذا لم يكن مثبّتًا لديك، يمكنك تنزيله من موقع Microsoft الرسمي. بالإضافة إلى ذلك، ستحتاج إلى وحدات نمطية محددة للاتصال بـ Microsoft Purview، وهي CAMP وAIPService.
إليك قائمة تحقق سريعة لضمان استيفاء المتطلبات المسبقة:
- إصدار PowerShell: تأكّد من توفر الإصدار 5.1 على الأقل .
- الوحدات النمطية: ثبّت الوحدتين النمطيتين CAMP وAIPService.
- الوصول الإداري: تأكّد من أن لديك صلاحيات إدارية في Purview.
باتباع هذه المتطلبات المسبقة، تكون قد هيّأت نفسك لتجربة سلسة عند إنشاء تقرير مجموعة الأدوار في Purview.
ملخص الخطوات
- تحقّق من إصدار PowerShell لديك.
- ثبّت الوحدات النمطية اللازمة.
- أكّد صلاحيات المسؤول لديك في Purview.
ستؤهلك متابعة هذه الخطوات لاستخدام PowerShell بفعالية في احتياجات إعداد التقارير لديك.
الاتصال بـ Microsoft Purview
إعداد الاتصال
للاتصال بـ Microsoft Purview باستخدام PowerShell، اتبع الخطوات التالية:
- تأكّد من امتلاك اشتراك Azure: تحتاج إلى اشتراك Azure صالح ومستأجر Microsoft Entra مرتبط به.
- سجّل الدخول إلى بوابة Azure: استخدم بيانات اعتماد حساب Azure الخاص بك للوصول إلى البوابة.
- ثبّت Azure PowerShell أو Azure CLI: تأكّد من تثبيت الأدوات اللازمة على جهاز العميل لديك.
- أنشئ مجموعة موارد: إذا لم تكن لديك مجموعة موارد، فنفّذ الأمر التالي:
New-AzResourceGroup -Name myResourceGroup -Location 'East US' - أنشئ حساب Microsoft Purview أو انشره: استخدم هذا الأمر لإعداد حساب Purview الخاص بك:
New-AzPurviewAccount
ستساعدك متابعة هذه الخطوات على إنشاء اتصال آمن بـ Microsoft Purview.
مصادقة بيانات الاعتماد
بعد إعداد الاتصال، تحتاج إلى مصادقة بيانات اعتمادك. إليك الطريقة:
- افتح PowerShell: شغّل PowerShell على جهازك.
- نفّذ أمر تسجيل الدخول: استخدم الأمر التالي لتسجيل الدخول:
يطالبك هذا الأمر بإدخال بيانات اعتماد حساب Azure الخاص بك.Connect-AzAccount - تحقّق من الاتصال: بعد تسجيل الدخول، تحقّق من إمكانية الوصول إلى حساب Purview الخاص بك بتنفيذ:
Get-AzPurviewAccount
إذا واجهت أي مشكلات أثناء عملية الاتصال، فضع في اعتبارك الأخطاء الشائعة التالية:
- كلمة مرور غير صحيحة: تحقّق مرة أخرى من اسم المستخدم وكلمة المرور.
- الوصول عبر PowerShell: تأكّد من تفعيل PowerShell لحسابك.
- الوصول إلى الشبكة: تأكّد من فتح المنفذ TCP 80 للاتصال بـ Microsoft 365.
- تثبيت الوحدات النمطية: تأكّد من تثبيت وحدتي PowerShellGet وPackageManagement معًا.
باتباع هذه الخطوات، يمكنك الاتصال بنجاح بـ Microsoft Purview ومصادقة بيانات اعتمادك، ما يمهّد الطريق لإنشاء تقرير مجموعة الأدوار الخاص بك.
إنشاء تقرير مجموعة أدوار Purview

نص PowerShell البرمجي لتقرير عضوية المجموعات
لـ إنشاء تقرير مجموعة أدوار Purview، يمكنك استخدام نص PowerShell البرمجي التالي. يتصل هذا النص بـ Microsoft Graph ويسترجع عضوية مجموعات الأدوار. اتبع الخطوات التالية لإنشاء تقريرك:
- الاتصال بـ Microsoft Graph: استخدم النطاقات المطلوبة للوصول إلى البيانات اللازمة.
- الاتصال بـ Exchange Online: تأكّد من إمكانية الوصول إلى نقطة نهاية الأمان والامتثال.
- استرجاع مجموعات الأدوار: نفّذ الأمر
Get-RoleGroupللعثور على جميع مجموعات الأدوار في المستأجر لديك. - تعداد العضوية: لكل مجموعة أدوار، حدّد العضوية الحالية. ميّز بين أنواع كائنات Entra ID المختلفة.
- تحديث قوائم PowerShell: أنشئ قوائم لتخزين تفاصيل كل تعيين دور وكل عضوية في مجموعة أدوار.
- تحديد المعرّفات الفريدة: ابحث عن المعرّفات الفريدة التي تحمل تعيينات الأدوار، مثل المستخدمين أو كيانات الخدمة.
- جمع تفاصيل الكائنات: لكل معرّف فريد، اجمع تفاصيل إضافية مثل القسم والدولة.
- فرز المعلومات: نظّم معلومات تعيين المستخدمين حسب نوع الكائن والاسم لتسهيل إعداد التقارير.
- إنشاء تقرير HTML: أنشئ تقرير HTML يتضمن تفاصيل كل مجموعة أدوار نشطة وعضويتها.
إليك نصًا برمجيًا نموذجيًا لPowerShell ينفّذ هذه الخطوات:
# Connect to Microsoft Graph
Connect-MgGraph -Scopes "Group.Read.All"
# Get role groups
$roleGroups = Get-RoleGroup
# Initialize lists
$roleGroupMemberships = @()
foreach ($group in $roleGroups) {
$members = Get-RbacGroupMember -GroupId $group.Id
foreach ($member in $members) {
$roleGroupMemberships += [PSCustomObject]@{
RoleGroupName = $group.DisplayName
MemberName = $member.DisplayName
MemberType = $member.ObjectType
}
}
}
# Generate HTML report
$roleGroupMemberships | ConvertTo-Html -Property RoleGroupName, MemberName, MemberType -Title "Purview Role Group Membership Report" | Out-File "PurviewRoleGroupReport.html"
سيساعدك هذا النص البرمجي على إنشاء تقرير شامل عن عضوية مجموعات الأدوار في Purview.
فهم بيانات المخرجات
بعد تشغيل نص PowerShell البرمجي، ستحصل على تقرير HTML يوضح عضويات مجموعات الأدوار. إليك كيفية تفسير بيانات المخرجات:
- اسم مجموعة الأدوار: يعرض هذا العمود اسم كل مجموعة أدوار.
- اسم العضو: يسرد هذا العمود أسماء المستخدمين أو كيانات الخدمة التي تنتمي إلى كل مجموعة أدوار.
- نوع العضو: يحدد هذا العمود ما إذا كان العضو مستخدمًا أم كيان خدمة أم نوعًا آخر من كائنات Entra ID.
من خلال تحليل هذه البيانات، يمكنك الحصول على رؤى حول عضويات مجموعات الأدوار داخل مؤسستك. وتُعد هذه المعلومات ضرورية لضمان التحكم في الوصول المستند إلى الأدوار (RBAC) والحفاظ على الامتثال الأمني.
تذكّر أن دقة العضويات المعروضة في التقرير تعتمد على الحالة الراهنة لبيئة Purview لديك. ويساعدك تحديث النصوص البرمجية والتقارير بانتظام على البقاء على اطلاع بأي تغييرات في عضويات مجموعات الأدوار.
أفضل الممارسات لإعداد التقارير
جدولة التقارير المنتظمة
للحفاظ على الامتثال والأمان، ينبغي عليك جدولة تقارير منتظمة عن مجموعات أدوار Purview. يساعدك إعداد التقارير المنتظم على معرفة من يشغل أدوار الامتثال، ويضمن التزام مؤسستك بنهج الأمان. وإليك بعض الخطوات التي تساعدك على جدولة هذه التقارير بفعالية:
- استخدام أوامر PowerShell: استفد من أوامر PowerShell لأتمتة عملية إنشاء التقارير. يمكنك إنشاء نص برمجي يعمل على فترات زمنية محددة.
- إعداد جدولة المهام: استخدم Windows Task Scheduler لتشغيل نص PowerShell البرمجي تلقائيًا. يضمن ذلك وصولك إلى تقارير محدّثة دون تدخل يدوي.
- اختيار تنسيقات التقارير: احفظ تقاريرك بتنسيقات آمنة مثل .PDF. يحمي ذلك المعلومات الحساسة ويسهّل مشاركتها مع المستخدمين المصرّح لهم.
نصيحة: طبّق دائمًا مبدأ الحد الأدنى من الامتيازات عند منح الوصول إلى التقارير. ويقلل ذلك من خطر الوصول غير المصرّح به.
تحليل بيانات التقارير
بمجرد إنشاء التقارير، يصبح تحليل البيانات أمرًا بالغ الأهمية. ففهم عضويات مجموعات أدوار الامتثال يساعدك على تحديد المخاطر الأمنية المحتملة. وإليك بعض الاستراتيجيات الفعّالة للتحليل:
- مراجعة العضويات بانتظام: تحقق من المنتمين إلى كل مجموعة أدوار. تأكد من أن المستخدمين المصرّح لهم فقط يملكون حق الوصول إلى البيانات الحساسة. تشمل مجموعات الأدوار الرئيسية Purview Administrators وData Source Administrators.
- تحديد الاتجاهات: ابحث عن الأنماط في عضويات مجموعات الأدوار. فقد يساعدك ذلك على رصد نشاط غير معتاد أو تغييرات تستدعي مزيدًا من التحقيق.
- توثيق النتائج: احتفظ بسجل لتحليلاتك. يمكن أن يكون هذا التوثيق دليلًا في عمليات تدقيق الامتثال، ويساعدك على تتبع التغييرات عبر الزمن.
باتباع أفضل الممارسات هذه، يمكنك تحسين عملية إعداد التقارير لديك والتأكد من أن مؤسستك تظل ملتزمة بمعايير الامتثال في Microsoft 365.
في هذا الدليل، تعلّمت كيفية إنشاء تقرير مجموعات أدوار Purview باستخدام PowerShell. اتصلت بـ Microsoft Purview، وأثبتت هويتك ببيانات الاعتماد الخاصة بك، ونفّذت نص PowerShell البرمجي لاسترجاع عضويات مجموعات الأدوار.
إعداد التقارير المنتظم أمر حيوي للحفاظ على الأمان والامتثال. فهو يساعدك على مراقبة الوصول وتحديد المخاطر المحتملة.
أشجعك على دمج هذه العملية في سير عملك. فذلك سيعزز وضعية الأمان لدى مؤسستك ويضمن الامتثال للمعايير الصناعية.
الأسئلة المتداولة
ما هو Microsoft Purview؟
Microsoft Purview حل موحّد لحوكمة البيانات يساعدك على إدارة بياناتك وحمايتها عبر بيئات متعددة. ويوفر أدوات لاكتشاف البيانات وتصنيفها والامتثال.
لماذا أستخدم PowerShell لتقارير Purview؟
يؤتمت استخدام PowerShell عملية إنشاء التقارير، مما يوفر وقتك ويقلل الأخطاء اليدوية. ويتيح لك استرجاع عضويات مجموعات الأدوار في Purview وإدارتها بكفاءة.
كم مرة ينبغي أن أنشئ تقارير مجموعات أدوار Purview؟
ينبغي أن تنشئ تقارير مجموعات أدوار Purview بشكل منتظم، ويفضل أن يكون ذلك شهريًا أو ربع سنويًا. تساعدك هذه الممارسة على مراقبة الوصول والحفاظ على الامتثال لنهج الأمان.
ماذا أفعل إذا واجهت أخطاء أثناء تشغيل نص PowerShell البرمجي؟
إذا واجهت أخطاء، فتحقق من أذوناتك، وتأكد من تثبيت جميع الوحدات المطلوبة، ومن صحة اتصالك بـ Microsoft Purview. راجع رسائل الخطأ للحصول على إرشادات محددة.
هل يمكنني تخصيص تنسيق التقرير؟
نعم، يمكنك تخصيص تنسيق التقرير. عدّل نص PowerShell البرمجي لتغيير تنسيق الإخراج، مثل إنشاء ملفات CSV أو PDF، بحسب احتياجاتك.
بوابة Purview وPurview Compliance
تركز هذه الأسئلة المتداولة على إنشاء تقرير مجموعة أدوار Purview باستخدام PowerShell، وتشرح الأذونات المرتبطة به، وإدارة الأدوار، والتدقيق في Microsoft Purview وMicrosoft 365.
وحدة PowerShell، وأذونات Microsoft Purview، وأدوار RBAC في Purview
يغطي الدليل استخدام وحدة PowerShell وMicrosoft Graph PowerShell SDK لعرض أعضاء مجموعات الأدوار، وفحص تعريفات الأدوار المضمنة، وإنشاء تقارير لسيناريوهات الامتثال وeDiscovery.
ما هو تقرير مجموعة أدوار Purview باستخدام PowerShell، ولماذا أُنشئه؟
تقرير مجموعة أدوار Purview باستخدام PowerShell هو قائمة مُنشأة (بصيغة CSV أو JSON) تتضمن مجموعات الأدوار، وتعيينات الأدوار (أدوار RBAC في Purview وتعيينات الأدوار المضمنة)، وأعضاء مجموعات الأدوار عبر حلول Microsoft Purview وخدمات Microsoft 365. تُنشئ هذا التقرير لتدقيق أذونات الأدوار، والتحقق من هوية من يملك صلاحية وصول بأدوار ذات امتيازات، مثل دور المسؤول الشامل أو دور مسؤول الإدارة، ولدعم مراجعات الامتثال وقضايا eDiscovery، أو لتزويد مراجعات الأذونات في إدارة التغيير وإدارة مخاطر المستخدمين الداخليين بالبيانات.
ما وحدة PowerShell التي أستخدمها لإنشاء تقرير لمجموعات أدوار Microsoft Purview؟
استخدم مجموعة من الوحدات بحسب بيئتك: Microsoft Graph PowerShell SDK للاستعلام عن تعيينات أدوار بوابة Microsoft Purview وأعضاء مجموعات الأدوار، وExchange Online Management Module أو وحدات Security & Compliance لبعض مجموعات الأدوار الخاصة بـ Microsoft 365 وeDiscovery. وتوثّق Microsoft أحيانًا أمثلة على Microsoft Learn لمهام بيانات Purview وبوابة Purview Compliance.
ما الأذونات التي أحتاجها لتشغيل تقرير مجموعة أدوار Purview باستخدام PowerShell؟
عادةً ما تحتاج إلى أدوار مرتفعة الصلاحيات، مثل دور المسؤول الشامل أو دور مسؤول مفوَّض يتمتع بقدرات إدارة الأدوار، أو أذونات محددة في Microsoft Purview، مثل الأدوار الإدارية في بوابة Purview (دور ذو امتيازات أو دور مسؤول). وقد يتطلب بعض الاستعلامات أن تكون عضوًا في مجموعة الأدوار Organization Management، أو مجموعة الأدوار eDiscovery Manager. تأكد من منح أذونات Graph اللازمة عند استخدام Microsoft Graph PowerShell SDK لقراءة تعيينات الأدوار وإدخالات سجل التدقيق.
كيف أعرض أعضاء مجموعات الأدوار وأدوارهم باستخدام Microsoft Graph PowerShell SDK؟
صادِق باستخدام أذونات مفوَّضة أو أذونات تطبيق تتضمن roleManagement.read.* وDirectory.Read.All، ثم استعلم عن roleDefinitions وroleAssignments لربط أدوار RBAC في Purview بمجموعات الأدوار وعرض أعضاء مجموعات الأدوار. صدّر النتائج إلى CSV لإنشاء التقرير. أما بالنسبة لمجموعات Exchange Online الخاصة، مثل مجموعة الأدوار eDiscovery Manager، فقد تحتاج إلى Exchange Online Management Module لعرض أعضاء مجموعات الأدوار وصلاحيات البحث في المحتوى.
هل يمكنني تضمين أدوار eDiscovery وحماية المعلومات في التقرير نفسه؟
نعم. اجمع البيانات من بوابة Microsoft Purview (لحلول Microsoft Purview وأدوار Microsoft Purview Data)، ومن خدمات Microsoft 365 (البحث في المحتوى، وقضايا eDiscovery، ودور eDiscovery Manager ومجموعة الأدوار eDiscovery Manager)، ومن تعيينات Microsoft Information Protection. استخدم عدة وحدات PowerShell أو استعلامات Graph لتجميع أذونات الأدوار، ثم وحّدها وصدّرها كتقرير واحد.
كيف أدقق التغييرات في مجموعات الأدوار وأتتبع أذونات الأدوار عبر الزمن؟
استخدم سجل التدقيق وأحداث تسجيل الدخول والتدقيق في Azure AD (Microsoft Entra / Microsoft Entra ID) المتاحة عبر Microsoft Graph PowerShell SDK أو واجهات برمجة تطبيقات التدقيق في بوابة Purview Compliance. جدوِل عمليات تصدير دورية لتعيينات الأدوار وقوائم أعضاء مجموعات الأدوار لاكتشاف التغييرات. ويتيح حفظ اللقطات التاريخية رصد الانحراف في الإعدادات وجمع أدلة الامتثال.
ما هي قيود الأدوار المدمجة الشائعة التي ينبغي الانتباه إليها في تقارير مجموعات أدوار Purview؟
قد تكون تعريفات الأدوار المدمجة واسعة النطاق (مثل Global Administrator وCompliance Administrator)، وقد تمنح الوصول عبر Purview Compliance وعمليات Purge والبيانات ذات الامتيازات. يجب أن يسلّط التقرير الضوء على تداخل الأدوار المدمجة ومجموعات الأدوار الافتراضية والتعيينات التي تمنح عمليًا صلاحيات مرتفعة إلى بيانات Microsoft Purview أو Microsoft Defender XDR أو Microsoft 365 Copilot. وتجدر الإشارة إلى أن بعض الأدوار المدمجة لا يمكن تعديلها، لكن يمكن إحصاؤها ومراقبتها.
كيف أتعامل مع مجموعات الأدوار للإدارة المفوضة وأقلل من تعرض الأدوار ذات الامتيازات للمخاطر؟
حدّد أعضاء مجموعات الأدوار المعيّنين لأدوار ذات امتيازات، وفكّر في تطبيق مبدأ أقل الامتيازات: أنشئ أدوارًا مخصصة أضيق نطاقًا إن أمكن، وأزل عضويات مجموعات الأدوار غير الضرورية، واستخدم ضوابط "الحساب الطارئ" (break-glass) للوصول في حالات الطوارئ. ينبغي أن يُظهر التقرير المستخدمين في مجموعة أدوار إدارة المؤسسة (organization management)، وحاملي أدوار المسؤول، وأي مبادئ خدمة (service principals) لديها تعيينات أدوار، لتقليل مخاطر الأدوار ذات الامتيازات.
أين يمكنني أن أجد أمثلة وأفضل الممارسات لإنشاء هذه التقارير وأتمتتها؟
راجع Microsoft Learn والتوثيق للاطلاع على أمثلة PowerShell باستخدام Microsoft Graph PowerShell SDK ووحدة Exchange Online Management وواجهات برمجة تطبيقات بوابة الامتثال. تشمل أفضل الممارسات أتمتة عمليات التصدير المجدولة، وتسجيل إدخالات سجل التدقيق، وتوثيق أذونات الأدوار كمجموعة من الأذونات، ودمج النتائج مع سير عمل الحوكمة لإدارة الأدوار ومراجعات أذونات الأدوار وعمليات تدقيق الامتثال.