安裝 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 資源庫 安裝 AIPService 模組
如果您不熟悉 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
如需詳細資訊,請參閱:
可用的 Cmdlet 完整清單: AIPService 模組
支援 PowerShell 的主要設定案例清單:使用 PowerShell 管理員 從 Azure 資訊保護 註冊保護
您必須先使用 連線-AipService Cmdlet 連線到服務,才能執行任何設定保護服務的命令。
當您完成執行組態命令時,最佳做法是使用 Disconnect-AipService Cmdlet 與服務中斷連線。 如果您未中斷連線,聯機會在閑置期間之後自動中斷連線。 由於自動中斷連線行為,您可能會發現您需要偶爾在PowerShell工作階段中重新連線。
注意
如果尚未啟用保護服務,您可以使用 Enable-AipService Cmdlet,在聯機到服務之後執行此動作。