你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

安装用于 Graph 的 Azure Active Directory PowerShell

项目
04/25/2024

重要

Azure AD Powershell 计划于 2024 年 3 月 30 日弃用。有关弃用计划的更多详细信息，请参阅弃用更新。我们建议你继续迁移到 Microsoft Graph PowerShell，这是与 Azure AD 交互的推荐模块。此外，Microsoft Graph PowerShell 允许访问所有 Microsoft Graph API，并在 PowerShell 7 上提供。有关频繁迁移查询的解答，请参阅迁移常见问题解答。

可以将 Azure Active Directory PowerShell 模块版本用于 Graph，用于 Azure AD 管理任务（例如用户管理、域管理）和配置单一登录。此处列出的 cmdlet 不同于 Azure Active Directory PowerShell 版本 1.0 中的 MSOnline cmdlet。

Azure AD PowerShell for Graph 模块有两个版本：公共预览版和正式发布版 (GA) 版本。不建议在生产场景中使用公共预览版。

从 PowerShell 库下载模块，请使用以下命令：

用于 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 中或基于 MSI 的安装程序 (（适用于 PowerShell 3 和 4) ）中提供。

使用最新 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 企业版
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 命令提示符下运行 cmdlet Connect-AzureAD。然后，系统会提示你输入凭据。如果需要，可以提前提供凭据，例如：

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

第一个命令提示输入凭据，并将凭据存储为 $AzureAdCred。下一个命令使用这些凭据作为 $azureadcred 连接到服务。

注意

Azure AD 和 Azure AD 预览版模块包含具有不同命名约定（即和 -AzureADMS）的 cmdlet。 -AzureAD 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。

后续步骤

请参阅新功能和改进。

通过