使用下列資訊來協助您從 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 資源庫安裝 AIPService 模組
如果您是 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
如需詳細資訊:
可用的 Cmdlet 完整清單: AIPService 模組
支援 PowerShell 的主要設定案例清單: 使用 PowerShell 管理 Azure Rights Management 服務
您必須先使用 Connect-AipService Cmdlet 連線到服務,才能執行任何設定 Azure Rights Management 服務的命令。
當您完成執行組態命令時,最佳做法是使用 Disconnect-AipService Cmdlet 中斷與服務的連線。 如果您不中斷連線,連線會在一段時間不活動後自動中斷連線。 由於自動中斷連線行為,您可能會發現您偶爾需要在 PowerShell 會話中重新連線。
注意事項
如果尚未啟用 Azure Rights Management 服務,您可以在連線到服務之後,使用 Enable-AipService Cmdlet 來執行此動作。