安裝適用於 Graph 的 Azure Active Directory PowerShell。

重要

Azure AD Powershell 計畫于 2024 年 3 月 30日淘汰。 如需有關淘汰方案的詳細資訊，請參閱 淘汰更新。 我們鼓勵您繼續移轉至 Microsoft Graph PowerShell，這是與 Azure AD 互動的建議模組。 此外，Microsoft Graph PowerShell 可讓您存取所有 Microsoft Graph API，並可在 PowerShell 7 上使用。 如需常見移轉查詢的解答，請參閱 移轉常見問題。

您可以使用適用于 Graph 的 Azure Active Directory PowerShell 模組版本來執行 Azure AD 系統管理工作，例如使用者管理、網域管理，以及設定單一登入。 此處列出的 Cmdlet 與屬於 Azure Active Directory PowerShell 1.0 版的 MSOnline Cmdlet 不同。

適用于 Graph 的 Azure AD PowerShell 模組有兩個版本：公開預覽版本和正式運作 (GA) 版本。 不建議在實際執行案例中使用公開預覽版本。

從 PowerShell 資源庫下載模組，請使用下列專案;

• AzureADPreview
• AzureAD

適用于 Graph 的 Azure Active Directory PowerShell 版本歷程記錄

Azure AD 模組和 Azure AD 預覽模組的發行歷程記錄如下：azure active directory powershell for graph：版本發行歷程記錄。

安裝 Azure AD 模組

必要條件

下列 Windows 作業系統支援 Azure AD 模組，其預設版本的 Microsoft .NET Framework 和 Windows PowerShell：

• Windows 8.1
• Windows 8
• Windows 7

• Windows Server 2012 R2、
• Windows Server 2012
• Windows Server 2008 R2。

注意

Azure AD PowerShell 模組與 PowerShell 7 不相容。 它僅在 PowerShell 5.1 中受到支援。

若要安裝模組的正式運作版本，請執行：

Install-Module AzureAD

若要安裝公開預覽版本，請執行：

Install-module AzureADPreview

您無法同時在同一部電腦上安裝預覽版本和 GA 版本。

關於 PowerShell 資源庫

Azure AD 模組會使用PowerShell 資源庫散發。 從資源庫安裝專案需要最新版的 PowerShellGet 模組，可在 Windows 10、Windows Management Framework (WMF) 5.0 中，或在適用于 PowerShell 3 和 4) 的 MSI 安裝程式 (中使用。

• 取得 Windows 10，
• 取得 WMF 5.0 或
• 取得 MSI 安裝程式

使用最新 PowerShellGet 模組，您可以：

• 使用 Find-Module 與 Find-Script 在資源庫中搜尋項目
• 使用 Save-Module 與 Save-Script 從資源庫將項目儲存到您的系統
• 使用 Install-Module 與 Install-Script 從資源庫安裝項目
• 使用 Publish-Module 與 Publish-Script 將項目上傳到資源庫
• 使用 Register-PSRepository 新增您自己的自訂存放庫

如需如何在資源庫使用 PowerShellGet 命令的詳細資訊，請查看開始使用頁面。 您也可以執行 Update-Help -Module PowerShellGet 以安裝這些命令的本機說明。

支援的作業系統

PowerShellGet 模組需要 PowerShell 3.0 或更新版本。

因此，PowerShellGet 需要下列其中一個作業系統：

• Windows 10
• Windows 8.1 專業版
• Windows 8.1 Enterprise
• Windows 7 SP1
• Windows Server 2016 TP5
• Windows Server 2012 R2
• Windows Server 2008 R2 SP1

PowerShellGet 也需要 .NET Framework 4.5 或更新版本。 您可以從這裡安裝 .NET Framework 4.5 或更新版本。

更新 Azure AD 模組

若要檢查電腦上安裝的模組版本，請執行此命令：

Get-Module AzureADPreview

ModuleType Version Name                ExportedCommands
---------- ------- ----                ----------------
Binary     2.0.0.7 azureadpreview     {Add-AzureADAdmini...

若要更新電腦上的 Azure AD PowerShell 模組版本，請重新執行 Install-Module Cmdlet：

Install-Module AzureADPreview

此命令會檢查 PowerShell 資源庫，以查看是否有較新的版本可用。 如果是，則比電腦上安裝的更新版本。

連接至 Azure AD

您必須先連線至線上服務，才可以執行本文中討論的任何 Cmdlet。 若要這麼做，請在 Windows PowerShell 命令提示字元執行 Connect-AzureAD Cmdlet。 然後系統會提示您輸入認證。 如果您想要，您可以事先提供認證，例如︰

$AzureAdCred = Get-Credential
Connect-AzureAD -Credential $AzureAdCred

第一個命令會提示提供認證，並將它們儲存為 $AzureAdCred。 下一個命令會使用那些認證作為 $azureadcred 以連線至服務。

注意

Azure AD 和 Azure AD 預覽模組是由具有不同命名慣例的 Cmdlet 所組成，也就是 -AzureAD 和 -AzureADMS 。 Cmdlet -AzureAD 會連線到 Azure AD Graph 端點 https://graph.windows.net ， -AzureADMS 而 Cmdlet 會呼叫 Microsoft Graph 端點 graph.microsoft.com 。 當您將呼叫從一個端點變更為另一個端點，而且系統不會再次提示您輸入認證時，就會以無訊息方式處理驗證。

若要連線到特定的 Azure Active Directory 環境，請使用 AzureEnvironment 參數，如下所示︰

Connect-AzureAD -AzureEnvironment "AzureGermanyCloud"

此範例會將 PowerShell 工作階段連線至德文版 AzureAD 環境。 如需詳細資訊，請參閱 Connect-AzureAD。

下一步

• 請參閱 新功能和改善。