使用以下信息帮助你从 Microsoft Purview 信息保护 安装 Azure Right Management 加密服务的 Windows PowerShell 模块。 此模块的名称为 AIPService，它将替换名为 AADRM 的以前版本。
可以使用此 PowerShell 模块从命令行管理 Azure Rights Management 加密服务，方法是使用具有 Internet 连接且满足下一部分中列出的先决条件的任何 Windows 计算机。 Azure Rights Management 的Windows PowerShell支持自动化脚本，或者对于高级配置方案可能是必需的。 有关模块支持的管理任务和配置的详细信息，请参阅 使用 PowerShell 管理 Azure Rights Management 服务。
先决条件
下表列出了安装和使用 Azure Rights Management 加密服务的 AIPService 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 包含在更高版本的作系统中，但如果尚未安装，可以下载 Microsoft .NET Framework 4.8。 AIPService 模块使用的某些类需要此最低版本的 Microsoft .NET Framework。 |
| 所需许可证 | 必须具有产品许可证才能使用此功能。 有关详细信息，请参阅 Microsoft 365 安全 & 合规性许可指南 - 服务说明。 |
如果已安装 AADRM 模块
AIPService 模块替换旧模块 AADRM。 如果已安装较旧的模块，请将其卸载，然后安装 AIPService 模块。
较新的模块具有旧模块中 cmdlet 名称的别名，以便任何现有脚本将继续工作。 旧模块在 2020 年 7 月 15 日不再受支持。
如果从 PowerShell 库安装了 AADRM 模块，若要卸载该模块，请使用“以管理员身份运行”选项启动 PowerShell 会话，然后键入：
Uninstall-Module -Name AADRM
如果使用 Azure Rights Management Administration Tool 安装了 AADRM 模块，请使用 Windows 删除应用程序过程卸载 Windows Azure AD Rights Management Administration。
如何安装 AIPService 模块
AIPService 模块位于PowerShell 库上，Microsoft下载中心不可用。
从 PowerShell 库安装 AIPService 模块
如果不熟悉PowerShell 库，请参阅PowerShell 库入门。 按照库要求的说明进行作，其中包括安装 PowerShellGet 模块和 NuGet 提供程序。
若要在PowerShell 库上查看有关 AIPService 模块的详细信息，请访问 AIPService 页面。
若要安装 AIPService 模块，请使用“ 以管理员身份运行 ”选项启动 PowerShell 会话，然后键入：
Install-Module -Name AIPService
如果收到有关从不受信任的存储库进行安装的警告，可以按 Y 进行确认。 或者，使用 命令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
有关详细信息，请参阅：
可用 cmdlet 的完整列表： AIPService 模块
支持 PowerShell 的主要配置方案列表： 使用 PowerShell 管理 Azure Rights Management 服务
必须先使用 Connect-AipService cmdlet 连接到服务，然后才能运行配置 Azure Rights Management 服务的任何命令。
运行完配置命令后，最佳做法是使用 Disconnect-AipService cmdlet 与服务断开连接。 如果不断开连接，连接会在处于非活动状态一段时间后自动断开连接。 由于自动断开连接行为，你可能会发现偶尔需要在 PowerShell 会话中重新连接。
注意
如果尚未激活 Azure Rights Management 服务，可以在连接到服务后使用 Enable-AipService cmdlet 执行此作。