Instalace modulu AIPService PowerShellu

  • Článek

Následující informace vám pomůžou nainstalovat modul Windows PowerShellu pro službu ochrany ze služby Azure Information Protection. Název tohoto modulu je AIPService a nahrazuje předchozí verzi s názvem AADRM.

Tento modul PowerShellu můžete použít ke správě služby ochrany (Azure Rights Management) z příkazového řádku pomocí libovolného počítače s Windows, který má připojení k internetu a který splňuje požadavky uvedené v další části. Windows PowerShell pro Azure Information Protection podporuje skriptování pro automatizaci nebo může být nezbytné pro pokročilé scénáře konfigurace. Další informace o úlohách a konfiguracích správy, které modul podporuje, najdete v tématu Správa stering ochrany ze služby Azure Information Protection pomocí PowerShellu.

Požadavky

Tato tabulka uvádí požadavky na instalaci a použití modulu AIPService PowerShell pro službu ochrany ze služby Azure Information Protection.

Požadavek Více informací
Minimální verze Windows PowerShellu Verze 3.0

Verzi Windows PowerShellu, kterou používáte, můžete potvrdit zadáním $PSVersionTable do relace PowerShellu. Pokud potřebujete nainstalovat novější verzi Windows PowerShellu, přečtěte si téma Upgrade stávajícího Windows PowerShellu.

Všimněte si, že modul AIPService PowerShell podporuje pouze Windows PowerShell. PowerShell 7 se nepodporuje.
Minimální verze rozhraní Microsoft .NET Framework Verze 4.8

Poznámka: Tato verze rozhraní Microsoft .NET Framework je součástí novějších operačních systémů, takže ji musíte nainstalovat ručně pouze v případě, že je váš klientský operační systém menší než Windows 8.0 nebo operační systém serveru je menší než Windows Server 2012.

Pokud minimální verze rozhraní Microsoft .NET Framework ještě není nainstalovaná, můžete si stáhnout rozhraní Microsoft .NET Framework 4.8. Tato minimální verze rozhraní Microsoft .NET Framework je nutná pro některé třídy, které modul AIPService používá.
Požadovaná licence Abyste mohli tuto funkci používat, musíte mít licenci na produkt. Další informace najdete v pokynech k licencování Microsoftu 365 pro zabezpečení a dodržování předpisů – Popisy služeb.

Pokud máte nainstalovaný modul AADRM

Modul AIPService nahrazuje starší modul AADRM. Pokud máte nainstalovaný starší modul, odinstalujte ho a pak nainstalujte modul AIPService.

Novější modul má aliasy pro názvy rutin ve starším modulu, aby všechny existující skripty dál fungovaly. Před ukončením podpory starého modulu však plánujete tyto odkazy aktualizovat. Podpora modulu AADRM skončí 15. července 2020.

Pokud jste nainstalovali modul AADRM z Galerie prostředí PowerShell, odinstalujte ho, spusťte relaci PowerShellu s možností Spustit jako Správa istrator a zadejte:

Uninstall-Module -Name AADRM

Pokud jste nainstalovali modul AADRM pomocí nástroje azure Rights Management Správa istrace, odinstalujte službu Windows Azure AD Rights Management pomocí nástrojů Programy a funkce Správa istrace.

Postup instalace modulu AIPService

Modul AIPService je na Galerie prostředí PowerShell a není k dispozici z webu Microsoft Download Center.

Pokud s Galerie prostředí PowerShell začínáte, přečtěte si téma Začínáme s Galerie prostředí PowerShell. Postupujte podle pokynů pro požadavky na galerii, mezi které patří instalace modulu PowerShellGet a zprostředkovatele NuGet.

Pokud chcete zobrazit podrobnosti o modulu AIPService na Galerie prostředí PowerShell, navštivte stránku AIPService.

Pokud chcete nainstalovat modul AIPService, spusťte relaci PowerShellu s možností Spustit jako Správa istrator a zadejte:

Install-Module -Name AIPService

Pokud se zobrazí upozornění na instalaci z nedůvěryhodného úložiště, můžete stisknutím klávesy Y potvrdit. Nebo stiskněte klávesu N a nakonfigurujte Galerie prostředí PowerShell jako důvěryhodné úložiště pomocí příkazu Set-PSRepository -Name PSGallery -InstallationPolicy Trusted a pak příkaz znovu spusťte a nainstalujte modul AIPService.

Pokud máte z galerie nainstalovanou předchozí verzi modulu AIPService, aktualizujte ho na nejnovější zadáním:

Update-Module -Name AIPService

Další kroky

V relaci Windows PowerShellu potvrďte verzi nainstalovaného modulu. Tato kontrola je obzvláště důležitá, pokud jste upgradovali ze starší verze:

(Get-Module AIPService –ListAvailable).Version

Poznámka:

Pokud tento příkaz selže, spusťte nejprve službu Import-Module AIPService.

Pokud chcete zjistit, které rutiny jsou k dispozici, zadejte následující:

Get-Command -Module AIPService

Get-Help <cmdlet_name> Pomocí příkazu zobrazíte nápovědu pro konkrétní rutinu a pomocí parametru -online zobrazíte nejnovější nápovědu na webu dokumentace Microsoftu. Příklad:

Get-Help Connect-AipService -online

Další informace:

Než budete moct spustit jakékoli příkazy, které konfigurují službu ochrany, musíte se ke službě připojit pomocí rutiny Připojení-AipService.

Po dokončení spouštění konfiguračních příkazů se jako osvědčený postup odpojte od služby pomocí rutiny Disconnect-AipService . Pokud se neodpojíte, připojení se po určité době nečinnosti automaticky odpojí. Kvůli chování automatického odpojení můžete zjistit, že v relaci PowerShellu budete občas muset znovu připojit.

Poznámka:

Pokud služba ochrany ještě není aktivovaná, můžete to udělat po připojení ke službě pomocí rutiny Enable-AipService .