安裝 AIPService PowerShell 模組

使用下列資訊可協助您從 Azure 資訊保護安裝保護服務的Windows PowerShell模組。 此模組的名稱是 AIPService,它會取代名為 AADRM 的舊版。

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

必要條件

下表列出從 Azure 資訊保護安裝及使用 AIPService PowerShell 模組保護服務的必要條件。

需求 更多資訊
最低版本的 Windows PowerShell 3.0 版

您可以在 PowerShell 工作階段中鍵入 $PSVersionTable 來確認您正在執行的 Windows PowerShell 版本。 若您需要安裝較新版本的 Windows PowerShell,請參閱更新現有的 Windows PowerShell

請注意,AIPService PowerShell 模組僅支援Windows PowerShell。 不支援 PowerShell 7。
Microsoft .NET Framework 的最低版本 版本 4.5

注意:此版本的 Microsoft .NET Framework隨附于較新的作業系統,因此只有在用戶端作業系統小於 Windows 8.0 或您的伺服器作業系統小於 Windows Server 2012 時,才需要手動安裝。

如果尚未安裝 Microsoft .NET Framework的最低版本,您可以下載Microsoft .NET Framework 4.5。 AIPService 模組所使用的某些類別需要這個最低版本的 Microsoft .NET Framework。
必要授權 您必須擁有產品授權才能使用此功能。 如需詳細資訊,請參閱 安全性 & 合規性的 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 Administration

如何安裝 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 連線至服務之後執行此動作。