توثيق الوصول الشرطي باستخدام PowerShell

يقوم هذا السكربت المكتوب بلغة PowerShell بتوثيق سياسات الوصول الشرطي (Conditional Access) في Microsoft Entra. يقوم السكربت بتصدير جميع البيانات كملف CSV يمكن تنسيقه بشكل جميل كدفتر عمل Excel. لضمان إمكانية استرداد وتوثيق جميع السياسات، يستخدم السكربت نقطة نهاية Microsoft Graph Beta API.

التثبيت والاستخدام

1. قم بتثبيت هذا السكربت من معرض PowerShell (يتم تثبيت الوحدة التابعة Microsoft.Graph.Authentication تلقائيًا):

   • Install-Script -Name Invoke-ConditionalAccessDocumentation -Scope CurrentUser
   • يتم حفظ السكربت في موقع السكربت الافتراضي للمستخدم:
     • Windows : C:\Users\%USERNAME%\Documents\WindowsPowerShell\Scripts
     • macOS: ~/.local/share/powershell/scripts

2. الاتصال بـ Microsoft Graph

   • منح موافقة المسؤول الأولية: Connect-Graph -Scopes "Application.Read.All", "Group.Read.All", "Policy.Read.All", "RoleManagement.Read.Directory", "User.Read.All", "NetworkAccess.Read.All" -ContextScope Process
   • بعد منح موافقة المسؤول الأولية، يمكنك الاتصال باستخدام: Connect-Graph للاستخدامات اللاحقة
   • إذا كنت تريد الاتصال عبر رمز Bearer من جلسة المتصفح، يمكنك استخدام المقتطف التالي للاتصال: Connect-MgGraph -AccessToken $((Get-Clipboard -Raw).Replace("Bearer ","").Replace("`n","") | ConvertTo-SecureString -AsPlainText -Force)

3. قم بتشغيل السكربت عبر PowerShell dot sourcing

   • .\Invoke-ConditionalAccessDocumentation.ps1

4. (اختياري) قم بتنسيق ملف CSV بشكل جميل مع Excel واحفظه كدفتر عمل Excel

   •