安装 AIPService PowerShell 模块

按照以下说明安装适用于 Azure 信息保护中的保护服务的 Windows PowerShell 模块。 此模块的名称为 AIPService,它将替代名为 AADRM 的旧版本。

使用任何具有 Internet 连接且满足下一部分列出的先决条件的 Windows 计算机,你可以从命令行通过此 PowerShell 模块来管理保护服务 (Azure Rights Management)。 适用于 Azure 信息保护的 Windows PowerShell 支持编写脚本来实现自动化,它还可能是高级配置方案所必需的。 若要深入了解此模块支持的管理任务和配置,请参阅使用 PowerShell 管理 Azure 信息保护中的保护服务

先决条件

此表列出了为 Azure 信息保护中的保护服务安装和使用 AADRM PowerShell 模块的先决条件。

要求 更多信息
最低版本的 Windows PowerShell 版本 3.0

你可在 PowerShell 会话中键入 $PSVersionTable,以确认正在运行的 Windows PowerShell 的版本。 如需安装更高版本的 Windows PowerShell,请参阅升级现有 Windows PowerShell

请注意,AIPService PowerShell 模块仅支持 Windows PowerShell。 尚不支持 PowerShell 7。
最低版本的 Microsoft .NET Framework 版本 4.8

注意:较新版本的操作系统中都包含此版本的 Microsoft .NET Framework,因此只有在你的客户端操作系统低于 Windows 8.0 或服务器操作系统低于 Windows Server 2012 的情况下,才需要手动安装它。

如果尚未安装 Microsoft .NET Framework 的最低版本,则可下载 Microsoft .NET Framework 4.8。 此最低版本的 Microsoft .NET Framework 是 AIPService 模块使用的某些类所必需的。
所需的许可证 你必须有产品许可证才能使用此功能。 有关详细信息,请参阅 Microsoft 365 安全性与合规性许可指南 - 服务说明

如果已安装 AADRM 模块

AIPService 模块将取代较旧的模块 AADRM。 如果安装了较旧的模块,请将其卸载,然后安装 AIPService 模块。

较新的模块具有较旧模块中的 cmdlet 名称的别名,因此,任何现有脚本都将继续工作。 但是,请计划好在旧模块不再受支持之前更新这些引用。 对 AADRM 模块的支持将在 2020 年 7 月 15 日结束。

如果你从 PowerShell 库安装了 AADRM 模块,则若要卸载它,请使用“以管理员身份运行”选项启动一个 PowerShell 会话,然后键入:

Uninstall-Module -Name AADRM

如果你通过 Azure Rights Management 管理工具安装了 AADRM 模块,请使用“程序和功能”来卸载“Windows Azure AD Rights Management 管理”。

如何安装 AIPService 模块

AIPService 模块在 PowerShell 库中,不可从 Microsoft 下载中心下载。

如果不熟悉 PowerShell 库,请参阅 PowerShell 库入门。 按照库要求的说明进行操作,其中包括安装 PowerShellGet 模块和 NuGet 提供程序的说明。

若要查看有关 PowerShell 库中的 AIPService 模块的详细信息,请访问 AIPService 页面

若要安装 AIPService 模块,请使用“以管理员身份运行”选项启动一个 PowerShell 会话,然后键入:

Install-Module -Name AIPService

如果从不受信任的存储库安装,将收到警告,可以按 Y 键确认。 或者,按 N 键并使用命令 Set-PSRepository -Name PSGallery -InstallationPolicy Trusted 将 PowerShell 库配置为受信任的存储库,然后重新运行命令以安装 AIPService 模块。

如果从库中安装了旧版 AIPService 模块,请键入以下命令将其更新为最新版本:

Update-Module -Name AIPService

后续步骤

在 Windows PowerShell 会话中,确认已安装模块的版本。 如果从较旧版本进行升级,则此检查非常重要:

(Get-Module AIPService –ListAvailable).Version

注意

如果此命令失败,请首先运行 Import-Module AIPService

若要查看可用的 cmdlet,请键入以下命令:

Get-Command -Module AIPService

使用 Get-Help <cmdlet_name> 命令查看有关特定 cmdlet 的帮助,使用 -online 参数查看 Microsoft 文档网站上的最新帮助。 例如:

Get-Help Connect-AipService -online

参考信息:

必须先使用 Connect-AipService cmdlet 连接到保护服务,然后才能运行用于配置保护服务的任何命令。

在配置命令完成运行后,最好使用 Disconnect-AipService cmdlet 断开与服务的连接。 如果不断开连接,处于不活动状态一段时间后将自动断开连接。 鉴于自动断开连接行为,你可能发现你需要在 PowerShell 会话中偶尔执行重新连接。

注意

如果尚未激活保护服务,则可在连接到该服务之后,使用 Enable-AipService cmdlet 进行激活。