共用方式為


安裝 Azure Right Management 服務的 AIPService PowerShell 模組

使用下列資訊來協助您從 Microsoft Purview 資訊保護 安裝 Azure Right Management 加密服務的 Windows PowerShell 模組。 此模組的名稱是 AIPService,它會取代先前名為 AADRM 的版本。

您可以使用此 PowerShell 模組,使用任何具有因特網連線且符合下一節所列必要條件的 Windows 電腦,從命令列管理 Azure Rights Management 加密服務。 適用於 Azure Rights Management 的 Windows PowerShell 支援自動化的腳本,或進階設定案例可能需要腳本。 如需模組支援之系統管理工作和設定的詳細資訊,請參閱 使用 PowerShell 管理 Azure Rights Management 服務

必要條件

下表列出針對 Azure Rights Management 加密服務安裝和使用 AIPService PowerShell 模組的必要條件。

需求 其他相關資訊
Windows PowerShell 的最低版本 版本 3.0

您可以在 Windows 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 管理工具安裝 AADRM 模組,請使用 Windows 移除應用程式程式來解除安裝 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 連線到服務,才能執行任何設定 Azure Rights Management 服務的命令。

當您完成執行組態命令時,最佳做法是使用 Disconnect-AipService Cmdlet 中斷與服務的連線。 如果您不中斷連線,連線會在一段時間不活動後自動中斷連線。 由於自動中斷連線行為,您可能會發現您偶爾需要在 PowerShell 會話中重新連線。

注意事項

如果尚未啟用 Azure Rights Management 服務,您可以在連線到服務之後,使用 Enable-AipService Cmdlet 來執行此動作。