Instalace modulu AIPService prostředí PowerShellInstalling the AIPService PowerShell module

*Platí pro: Azure Information Protection, Office 365**Applies to: Azure Information Protection, Office 365*

*Relevantní pro: AIP s jednotným označením klienta a klasického klienta**Relevant for: AIP unified labeling client and classic client*

Poznámka

Pro zajištění jednotného a zjednodušeného prostředí pro zákazníky se Azure Information Protection klasický klient a Správa štítků na portálu Azure Portal od 31. března 2021.To provide a unified and streamlined customer experience, the Azure Information Protection classic client and Label Management in the Azure Portal are deprecated as of March 31, 2021. I když klasický klient nadále funguje tak, jak je nakonfigurován, není k dispozici žádná další podpora a verze údržby již nebudou pro klasického klienta uvolněny.While the classic client continues to work as configured, no further support is provided, and maintenance versions will no longer be released for the classic client.

Doporučujeme migrovat na jednotné označování a upgradovat na klienta jednotného označování.We recommend that you migrate to unified labeling and upgrade to the unified labeling client. Další informace najdete na našem nedávný blogo vyřazení.Learn more in our recent deprecation blog.

Následující informace vám pomůžou nainstalovat modul Windows PowerShell pro službu ochrany z Azure Information Protection.Use the following information to help you install the Windows PowerShell module for the protection service from Azure Information Protection. Název tohoto modulu je AIPService a nahrazuje předchozí verzi s názvem AADRM.The name of this module is AIPService, and it replaces the previous version that was named 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.You can use this PowerShell module to administer the protection service (Azure Rights Management) from the command line by using any Windows computer that has an internet connection and that meets the prerequisites listed in the next section. Prostředí Windows PowerShell pro Azure Information Protection podporuje skriptování pro automatizaci nebo může být nezbytné pro pokročilé scénáře konfigurace.Windows PowerShell for Azure Information Protection supports scripting for automation or might be necessary for advanced configuration scenarios. Další informace o úlohách správy a konfiguracích, které modul podporuje, najdete v tématu Správa ochrany z Azure Information Protection pomocí prostředí PowerShell.For more information about the administration tasks and configurations that the module supports, see Administering protection from Azure Information Protection by using PowerShell.

PožadavkyPrerequisites

Tato tabulka obsahuje seznam požadavků pro instalaci a použití modulu AIPService PowerShell pro službu ochrany z Azure Information Protection.This table lists the prerequisites to install and use the AIPService PowerShell module for the protection service from Azure Information Protection.

PožadavekRequirement Další informaceMore information
Minimální verze prostředí Windows PowerShell: 3,0Minimum version of Windows PowerShell: 3.0 Verzi prostředí Windows PowerShell, kterou používáte, si můžete ověřit zadáním $PSVersionTable v relaci PowerShellu.You can confirm the version of Windows PowerShell that you are running by typing $PSVersionTable in a PowerShell session.

Pokud potřebujete nainstalovat novější verzi Windows PowerShellu, přečtěte si téma Upgrade stávajícího Windows PowerShellu.If you need to install a later version of Windows PowerShell, see Upgrading existing Windows PowerShell.
Minimální verze rozhraní Microsoft .NET Framework: 4.5Minimum version of the Microsoft .NET Framework: 4.5

Poznámka: Tato verze rozhraní Microsoft .NET Framework je součástí novějších operačních systémů, proto byste ho měli ručně instalovat jen tehdy, když je váš klientský operační systém klienta menší než Windows 8.0 nebo serverový operační systému je menší než Windows Server 2012.Note: This version of the Microsoft .NET Framework is included with the later operating systems, so you should need to manually install it only if your client operating system is less than Windows 8.0 or your server operating system is less than Windows Server 2012.
Pokud už není nainstalovaná minimální verze rozhraní Microsoft .NET Framework, můžete si stáhnout rozhraní Microsoft .NET Framework 4.5.If the minimum version of the Microsoft .NET Framework is not already installed, you can download Microsoft .NET Framework 4.5.

Tato minimální verze Microsoft .NET Framework je vyžadována pro některé třídy, které používá modul AIPService.This minimum version of the Microsoft .NET Framework is required for some of the classes that the AIPService module uses.

Pokud máte nainstalovaný modul AADRMIf you have the AADRM module installed

Modul AIPService nahrazuje starší modul AADRM.The AIPService module replaces the older module, AADRM. Pokud máte nainstalovaný starší modul, odinstalujte ho a pak nainstalujte modul AIPService.If you have the older module installed, uninstall it and then install the AIPService module.

Novější modul obsahuje aliasy pro názvy rutin ve starším modulu, takže všechny existující skripty budou fungovat i nadále.The newer module has aliases to the cmdlet names in the older module so that any existing scripts will continue to work. Nicméně Naplánujte aktualizaci těchto odkazů předtím, než starý modul odpadne na podporu.However, plan to update these references before the old module falls out of support. Podpora modulu AADRM skončí 15. července 2020.Support for the AADRM module will end July 15, 2020.

Pokud jste modul AADRM nainstalovali z Galerie prostředí PowerShell pro jeho odinstalaci, spusťte relaci PowerShellu s možností Spustit jako správce a zadejte:If you installed the AADRM module from the PowerShell Gallery, to uninstall it, start a PowerShell session with the Run as Administrator option, and type:

Uninstall-Module -Name AADRM

Pokud jste nainstalovali modul AADRM pomocí nástroje pro správu služby Azure Rights Management, odinstalujte program Windows Azure AD Rights Management Administration pomocí programů a funkcí .If you installed the AADRM module with the Azure Rights Management Administration Tool, use Programs and Features to uninstall Windows Azure AD Rights Management Administration.

Jak nainstalovat modul AIPServiceHow to install the AIPService module

Modul AIPService je na Galerie prostředí PowerShell a není k dispozici na webu Microsoft Download Center.The AIPService module is on the PowerShell Gallery and is not available from the Microsoft Download Center.

Pokud s Galerie prostředí PowerShellem začínáte, přečtěte si téma Začínáme s Galerie prostředí PowerShell.If you're new to the PowerShell Gallery, see Get Started with the PowerShell Gallery. Postupujte podle pokynů pro požadavky galerie, které zahrnují instalaci modulu PowerShellGet a poskytovatele NuGet.Follow the instructions for the gallery requirements, which include installing the PowerShellGet module and the NuGet provider.

Pokud chcete zobrazit podrobnosti o modulu AIPService na Galerie prostředí PowerShell, navštivte stránku AIPService.To see details about the AIPService module on the PowerShell Gallery, visit the AIPService page.

Pokud chcete nainstalovat modul AIPService, spusťte relaci PowerShellu s možností Spustit jako správce a zadejte:To install the AIPService module, start a PowerShell session with the Run as Administrator option, and type:

Install-Module -Name AIPService

Pokud se vám zobrazí upozornění týkající se instalace z nedůvěryhodného úložiště, můžete pro potvrzení stisknout klávesu Y.If you are warned about installing from an untrusted repository, you can press Y to confirm. 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 znovu spusťte příkaz pro instalaci modulu AIPService.Or, press N and configure the PowerShell Gallery as a trusted repository by using the command Set-PSRepository -Name PSGallery -InstallationPolicy Trusted and then rerun the command to install the AIPService module.

Pokud máte z Galerie nainstalovanou předchozí verzi modulu AIPService, aktualizujte ji na nejnovější, a to tak, že zadáte:If you have a previous version of the AIPService module installed from the Gallery, update it to the latest by typing:

Update-Module -Name AIPService

Další krokyNext steps

V relaci prostředí Windows PowerShell potvrďte verzi nainstalovaného modulu.In a Windows PowerShell session, confirm the version of the installed module. Tato kontrola je zvlášť důležitá, pokud jste upgradovali ze starší verze:This check is particularly important if you upgraded from an older version:

(Get-Module AIPService –ListAvailable).Version

Poznámka

Pokud tento příkaz neproběhne úspěšně, spusťte nejprve Import-Module AIPService.If this command fails, first run Import-Module AIPService.

Pokud chcete zjistit, jaké rutiny jsou dostupné, zadejte tento příkaz:To see which cmdlets are available, type the following:

Get-Command -Module AIPService

Pomocí příkazu Get-Help <cmdlet_name> si můžete zobrazit nápovědu k určité rutině. Když použijete parametr -online, zobrazí se nejnovější nápověda na webu dokumentace Microsoftu.Use the Get-Help <cmdlet_name> command to see the Help for a specific cmdlet, and use the -online parameter to see the latest help on the Microsoft documentation site. Například:For example:

Get-Help Connect-AipService -online

Další informace najdete tady:For more information:

Než budete moct spustit všechny příkazy, které konfigurují službu ochrany, musíte se ke službě připojit pomocí rutiny Connect-AipService .Before you can run any commands that configure the protection service, you must connect to the service by using the Connect-AipService cmdlet.

Když jste dokončili příkazy konfigurace, je osvědčeným postupem odpojení od služby pomocí rutiny Connect-AipService .When you have finished running your configuration commands, as a best practice, disconnect from the service by using the Disconnect-AipService cmdlet. Pokud se neodpojíte, připojení se automaticky odpojí po určité době nečinnosti.If you do not disconnect, the connection is automatically disconnected after a period of inactivity. V důsledku tohoto automatického odpojování se zřejmě budete muset v relaci PowerShellu občas znovu připojit.Because of the automatic disconnection behavior, you might find that you need to occasionally reconnect in a PowerShell session.

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 .If the protection service is not yet activated, you can do this after you have connected to the service, by using the Enable-AipService cmdlet.