安裝 AIPService PowerShell 模組以支援 Azure Rights Management 服務

Microsoft Purview 服務描述

請參考以下資訊,協助您安裝 Microsoft Purview 資訊保護的 Azure 權利管理加密服務的 Windows PowerShell 模組。 此模組名稱為 AIPService,取代了先前名為 AADRM 的版本。

您可以使用此 PowerShell 模組,使用任何有網路連線且符合下表前提條件的 Windows 電腦,從命令列管理 Azure 權利管理加密服務。 Azure 權利管理服務的 Windows PowerShell 支援自動化腳本,或在進階設定場景中可能需要。 欲了解更多關於 AIPService 模組所支援的管理任務與設定,請參閱「使用 PowerShell 管理 Azure 權利管理服務」。

必要條件

此表列出安裝及使用 Azure Rights Management 加密服務 AIPService PowerShell 模組的前置條件。

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

你可以透過輸入 $PSVersionTable PowerShell 會話來確認你正在執行的 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。 這個 Microsoft .NET Framework 的最低版本是 AIPService 模組所使用的部分類別所必需的。
所需執照 您必須擁有產品授權才能使用此功能。 欲了解更多資訊,請參閱 Microsoft 365 安全 & 合規授權指引 - 服務說明

如果你已經安裝了 AADRM 模組

AIPService 模組取代了舊有的 AADRM 模組。 如果你已經安裝了舊模組,先卸載它,然後再安裝 AIPService 模組。

AIPService 模組與 AADRM 模組中的 cmdlet 名稱有別名,因此任何現有腳本都能繼續運作。 AADRM 模組於 2020 年 7 月 15 日停止支援。

如果你從 PowerShell 資源庫安裝了 AADRM 模組,要解除安裝,請以「以管理員身份執行」選項啟動 PowerShell 工作階段,然後輸入:

Uninstall-Module -Name AADRM

如果你用 Azure 權利管理管理工具安裝了 AADRM 模組,請使用 Windows 移除應用程式程序來卸載 Windows Azure AD 權利管理管理

如何安裝 AIPService 模組

AIPService 模組位於 PowerShell 資源庫中,且無法從 Microsoft 下載中心取得。

如果你是 PowerShell 資源庫的新手,請參考「使用 PowerShell 資源庫開始」。 請依照 PowerShell 資源庫的設定說明操作,包括安裝 PowerShellGet 模組和 NuGet 提供者。

欲了解 PowerShell 資源庫中 AIPService 模組的詳細資訊,請造訪 PowerShell 資源庫中的 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

注意事項

(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

如需詳細資訊:

在你執行任何設定 Azure 權利管理服務的指令之前,必須先使用 Connect-AipService 指令檔連接該服務。

當你執行完設定指令後,作為最佳做法,建議使用 Disconnect-AipService 指令檔斷開服務連線。 如果你沒有斷線,連線會在一段時間不使用後自動斷線。 因為自動斷線行為,你可能會發現偶爾需要在 PowerShell 工作階段重新連線。

注意事項

如果 Azure 權利管理服務尚未啟用,你可以在連接服務後,使用 Enable-AipService 指令碼來啟用它。