PowerShell で条件付きアクセスを文書化する

この PowerShell スクリプトは、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 のドットソーシングでスクリプトを実行します

   • .\Invoke-ConditionalAccessDocumentation.ps1

4. （任意）Excel で csv を見やすく整形し、Excel ブックとして保存します

   •