共用方式為


安裝 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.8 版

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

如果尚未安裝 Microsoft .NET Framework 的最低版本,您可以下載 Microsoft .NET Framework 4.8。 AIPService 模組使用的一些類別需要這個最低版本的 Microsoft .NET Framework。
必要授權 您必須擁有產品授權才能使用這項功能。 如需詳細資訊,請參閱 安全性與合規性的 Microsoft 365 授權指引 - 服務描述

如果您已安裝 AADRM 模組

AIPService 模組會取代較舊的模組 AADRM。 如果您已安裝較舊的模組,請將其卸載,然後安裝 AIPService 模組。

較新的模組具有舊模組中 Cmdlet 名稱的別名,讓任何現有的腳本都能夠繼續運作。 不過,在舊模組不支援之前,請規劃更新這些參考。 AADRM 模組的支援將於 2020 年 7 月 15 日結束。

如果您從 PowerShell 資源庫 安裝 AADRM 模組,若要卸載它,請使用 [以 管理員 istrator 執行] 選項啟動 PowerShell 會話,然後輸入:

Uninstall-Module -Name AADRM

如果您使用 Azure Rights Management 管理員 istration Tool 安裝 AADRM 模組,請使用程式和功能來卸載 Windows Azure AD Rights Management 管理員 istration

如何安裝 AIPService 模組

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

如果您不熟悉 PowerShell 資源庫,請參閱開始使用 PowerShell 資源庫。 請遵循資源庫需求的指示,包括安裝PowerShellGet模組和 NuGet 提供者。

若要查看 PowerShell 資源庫 上 AIPService 模組的詳細數據,請流覽 AIPService 頁面

若要安裝 AIPService 模組,請使用 [以執行身分 管理員 istrator] 選項啟動 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

如需詳細資訊,請參閱:

您必須先使用 連線-AipService Cmdlet 連線到服務,才能執行任何設定保護服務的命令。

當您完成執行組態命令時,最佳做法是使用 Disconnect-AipService Cmdlet 與服務中斷連線。 如果您未中斷連線,聯機會在閑置期間之後自動中斷連線。 由於自動中斷連線行為,您可能會發現您需要偶爾在PowerShell工作階段中重新連線。

注意

如果尚未啟用保護服務,您可以使用 Enable-AipService Cmdlet,在聯機到服務之後執行此動作。