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

Azure Active Directory (MSOnline)

重要

截至 2024 年 3 月 30 日，Azure AD 和 MSOnline PowerShell 模块已弃用。 若要了解详细信息，请阅读 弃用更新。 在此日期之后，对这些模块的支持仅限于 Microsoft Graph PowerShell SDK 和安全修补程序的迁移帮助。 弃用的模块将继续运行到 2025 年 3 月 30 日。

建议迁移到 Microsoft Graph PowerShell，以便与以前为 Azure AD) Microsoft Entra ID (进行交互。 有关常见迁移问题，请参阅 迁移常见问题解答。 注意： 1.0.x 版 MSOnline 可能会在 2024 年 6 月 30 日之后遇到中断。

可以将 MSOnline cmdlet 用于 Azure AD 管理任务，例如用户管理、域管理和配置单一登录。 本主题包含有关如何安装这些可以针对目录使用的 cmdlet 的信息。

安装 MSOnline

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

可以从PowerShell 库安装此模块。

连接到 Azure AD

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

$Msolcred = Get-credential
Connect-MsolService -Credential $MsolCred

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

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

Connect-MsolService -AzureEnvironment "AzureGermanyCloud"

此示例将 PowerShell 会话连接到德语 AzureAD 环境。

有关详细信息，请参阅 Connect-MsolService。

如需有关 cmdlet 的详细信息，可执行以下操作：

• 要创建帮助文件夹、列出 cmdlet，并在记事本中打开该文件，可以在 Windows PowerShell 命令提示符下运行以下命令：

New-Item c:\MsolHelp -Type directory
Get-command | Where-Object {$_.name -like "*msol*"} | Format-List | Out-File c:\MsolHelp\msolcmdlets.txt
Notepad c:\MsolHelp\msolcmdlets.txt

• 若要查看 cmdlet 的示例，请在 Windows PowerShell 命令提示符下运行以下命令：Get-Help <cmdlet-name> -Examples

• 若要查看 cmdlet 的名称、摘要、说明、参数说明和提供的任何示例，请在 Windows PowerShell 命令提示符下运行以下命令：Get-Help <cmdlet-name> -Detailed

• 若要查看 cmdlet 的名称、摘要、说明、详细参数和提供的任何示例，请在 Windows PowerShell 命令提示符下运行以下命令：Get-Help <cmdlet-name> -Full

注意

MSOnline PowerShell 只能由作为目录成员的用户使用。 来宾用户不能使用 MSOnline 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。 有关 Windows PowerShell 的详细信息，请参阅 Windows PowerShell 入门。