你当前正在访问 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 (进行交互。 有关常见的迁移问题，请参阅 迁移常见问题解答。 注意： 2024 年 6 月 30 日之后，MSOnline 版本 1.0.x 可能会遇到中断。

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

安装 MSOnline

MSonline 在以下具有默认版本的 Microsoft .NET Framework 和 Windows PowerShell 的 Windows 操作系统上受支持：Windows 8.1、Windows 8、Windows 7 Windows Server 2012 R2、Windows Server 2012 或 Windows Server 2008 R2。

安装模块的最简单方法是从PowerShell 库。 可以使用 Install-Module cmdlet 安装该模块：

Install-Module MSOnline

连接到 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

另请参阅