對象
欲串接 Microsoft 365 和 HENNGE Access Control 的客戶。
目的
透過 PowerShell 串接 Microsoft 365 ，以便於管理網域。
注意事項
1. 透過目前裝置上的 PowerShell 串接 Microsoft365 需要安裝相對應的模組。
2. 需要 Microsoft365 全網域的管理者帳號。
3. 本文基於2024年4月時點的產品內容撰寫，未來可能會因更新或規格變更而不經預告地進行更改。
詳細步驟・説明
事前確認事項
1. 須事先在 PowerShell 下載 Microsoft Graph PowerShell SDK 模組。
請確認有完成下列內容。
安裝 Microsoft Graph PowerShell SDK
1. 連接 Microsoft Graph PowerShell 和 Microsoft 365
1-1. 點選 Windows 的 [ 開始 ] ，並使用系統管理員權限開啟[ Windows PowerShell ] 。
※ 開啟 PowerShell 後左上會顯示 [ 管理員 ] 。
1-2. 執行下列程式碼。
Connect-MgGraph
※ 若執行程式碼後出現紅色 error 請參考下列文章。
Microsoft Graph PowerShell を実行時、TLS 1.0 / TLS 1.1 エラーの対処方法
1-3. 出現登入提示時，請使用具有 [全網域管理者] 權限的 Microsoft 365 帳號登入。
1-4. 確認 Microsoft Graph PowerShell 連接。
連接成功會顯示[ Welcome To Microsoft Graph ! ] 。
2. ( 任意 ) 為了檢查是否有證查連接，請執行以下程式碼進行確認。
Get-MgUser
若正常連接至 Microsoft 365 ，程式碼的執行結果會顯示在 Microsoft 365 上的使用者一覽。
※ 若沒有賦予 Microsoft Graph PowerShell 必要的存取權限，上述的程式碼測試可能會失敗。若發生這樣的狀況請在 1-2. 執行下列程式碼並再次嘗試。
Connect-MgGraph -Scopes "Organization.Read.All"
3.切斷 Microsoft Graph 的連線
執行下方程式碼將和 Microsoft Graph 的連線切斷。
Disconnect-MgGraph
※ 使用 [Connect-MgGraph] 命令時，下次啟動時將不需要再要求登入，前次驗證過的資格證將被保留。
為確保完全斷開登入，請務必執行 [Disconnect-MgGraph] 命令。