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

Azure Active Directory Graph PowerShell

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

Azure AD PowerShell for Graph 模块有两个版本：公共预览版和正式发布版。 不建议将公共预览版用于生产方案。

可以从 AzureADPreview 页上的PowerShell 库下载 Azure AD PowerShell for Graph 预览版模块。

可以从 AzureAD 页上的 PowerShell 库下载适用于 Graph 的 Azure AD PowerShell 正式版模块。

安装 Azure AD 模块

以下具有 Microsoft .NET Framework 和 Windows PowerShell 的默认版本的 Windows 操作系统支持 Azure AD PowerShell for Graph 模块：Windows 8.1、Windows 8、Windows 7、Windows Server 2012 R2、Windows Server 2012 或 Windows Server 2008 R2。

如果计算机满足所有的安装先决条件，若要在计算机上安装正式版模块，可以运行

Install-Module AzureAD

若要安装公共预览版，请使用

Install-module AzureADPreview

请注意，无法在同一台计算机上同时安装预览版和正式版。

关于 PowerShell 库

Azure AD 模块使用 PowerShell 库分发。 从库安装项需要最新版本的 PowerShellGet 模块，Windows 10、Windows Management Framework (WMF) 5.0 或基于 MSI 的安装程序（适用于 PowerShell 3 和 4）中提供此模块。

• 获取 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 企业版
• 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 模块

可运行以下命令检查计算机上安装的模块版本：

PS C:\WINDOWS\system32> Get-Module AzureADPreview

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

若要更新计算机上的 Azure AD PowerShell 模块版本，请重新运行 Install-module cmdlet：

PS C:\WINDOWS\system32> Install-Module AzureADPreview

此命令会检查 PowerShell 库，确定是否有更新的版本可用，如果 PowerShell 库中的版本比计算机上安装的版本更新，会在计算机上安装新版本。

连接到 Azure AD

运行本文中所述的任何 cmdlet 之前，必须先连接到在线服务。 为此，请在 Windows PowerShell 命令提示符下运行 cmdlet Connect-AzureAD。 然后，系统会提示输入凭据。 如果需要，可以提前提供凭据，例如：

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

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

若要连接到 Azure Active Directory 的特定环境，请使用 AzureEnvironment 参数，如下所示：

Connect-AzureAD -AzureEnvironment "AzureGermanyCloud"

此示例将 PowerShell 会话连接到德语 AzureAD 环境。 有关详细信息，请参阅 Connect-AzureAD。

建议？

如果对如何改进 Azure Active Directory PowerShell 有建议，请随时 告知我们！

有关 Windows PowerShell 的详细信息

Windows PowerShell 是基于任务的命令行 shell 和脚本语言，专为系统管理而设计。 与大多数接受并返回文本的 shell 不同，Windows PowerShell 构建在 .NET Framework 的基础之上，接受并返回 .NET Framework 对象。

Windows PowerShell 引入了 cmdlet（读作“command-let”）的概念，它是内置于 Shell 的简单的单一函数命令行工具。 Cmdlet 采用以下命名约定：动词和名词以短划线 (-) 分隔，例如 Get-Help、Get-Process 和 Start-Service。 Windows PowerShell 包含一百多个基本核心 cmdlet。

有关任何 cmdlet 的详细信息或语法，请使用 Get-Help <cmdlet name> 命令，其中 <cmdlet name> 是要研究的 cmdlet 的名称。 如需更多详细信息，可运行以下任一命令：

• Get-Help <cmdlet name> -Detailed
• Get-Help <cmdlet name> -Examples
• Get-Help <cmdlet name> -Full

有关 Windows PowerShell 的详细信息，请参阅 Windows PowerShell 入门。