De PowerShell-module AIPService installerenInstalling the AIPService PowerShell module

*Van toepassing op: Azure Information Protection, Office 365**Applies to: Azure Information Protection, Office 365*

Relevant voor: in het Algemeen gelabelde client en klassieke client*Relevant for: AIP unified labeling client and classic client*

Notitie

Om een geïntegreerde en gestroomlijnde klant ervaring te bieden, zijn de Azure Information Protection klassieke client en Label beheer in azure Portal verouderd vanaf 31 maart 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. Terwijl de klassieke client blijft werken zoals geconfigureerd, wordt er geen verdere ondersteuning geboden en worden er geen onderhouds versies meer vrijgegeven voor de klassieke client.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.

We raden u aan om te migreren naar Unified labels en een upgrade uit te voeren naar de Unified labeling-client.We recommend that you migrate to unified labeling and upgrade to the unified labeling client. Meer informatie vindt u in onze recente blog voor afschaffing.Learn more in our recent deprecation blog.

Gebruik de volgende informatie om u te helpen bij het installeren van de Windows Power shell-module voor de beveiligings service van Azure Information Protection.Use the following information to help you install the Windows PowerShell module for the protection service from Azure Information Protection. De naam van deze module is AIPService en vervangt de vorige versie met de naam AADRM.The name of this module is AIPService, and it replaces the previous version that was named AADRM.

U kunt deze Power shell-module gebruiken om de beveiligings service (Azure Rights Management) te beheren vanaf de opdracht regel met behulp van een Windows-computer met een Internet verbinding die voldoet aan de vereisten die worden vermeld in de volgende sectie.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. Windows Power shell voor Azure Information Protection ondersteunt het uitvoeren van scripts voor Automation of is mogelijk nood zakelijk voor geavanceerde configuratie scenario's.Windows PowerShell for Azure Information Protection supports scripting for automation or might be necessary for advanced configuration scenarios. Zie beveiliging beheren vanuit Azure Information Protection met behulp van Power shellvoor meer informatie over de beheer taken en-configuraties die door de module worden ondersteund.For more information about the administration tasks and configurations that the module supports, see Administering protection from Azure Information Protection by using PowerShell.

VereistenPrerequisites

Deze tabel bevat de vereisten voor het installeren en gebruiken van de AIPService Power shell-module voor de beveiligings service van Azure Information Protection.This table lists the prerequisites to install and use the AIPService PowerShell module for the protection service from Azure Information Protection.

VereisteRequirement Meer informatieMore information
Minimale versie van Windows Power shell: 3,0Minimum version of Windows PowerShell: 3.0 U kunt controleren welke versie van Windows Power shell u gebruikt door $PSVersionTable een Power shell-sessie te typen.You can confirm the version of Windows PowerShell that you are running by typing $PSVersionTable in a PowerShell session.

Als u een nieuwere versie van Windows PowerShell moet installeren, leest u dit artikel op GitHub over het upgraden van een bestaande Windows PowerShell-versie.If you need to install a later version of Windows PowerShell, see Upgrading existing Windows PowerShell.
De minimaal vereiste versie van Microsoft .NET Framework: 4.5Minimum version of the Microsoft .NET Framework: 4.5

Opmerking: deze versie van Microsoft .NET Framework is inbegrepen bij de nieuwere besturingssystemen. U hoeft deze dus alleen handmatig te installeren als uw clientbesturingssysteem ouder is dan Windows 8.0 of als uw serverbesturingsysteem ouder is dan 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.
Als de minimaal vereiste versie van Microsoft .NET Framework nog niet is geïnstalleerd, kunt u Microsoft .NET Framework 4.5 downloaden.If the minimum version of the Microsoft .NET Framework is not already installed, you can download Microsoft .NET Framework 4.5.

Deze minimale versie van het Microsoft .NET Framework is vereist voor een aantal klassen die door de AIPService-module worden gebruikt.This minimum version of the Microsoft .NET Framework is required for some of the classes that the AIPService module uses.

Als u de AADRM-module hebt geïnstalleerdIf you have the AADRM module installed

De AIPService-module vervangt de oudere module, AADRM.The AIPService module replaces the older module, AADRM. Als u de oudere module hebt geïnstalleerd, verwijdert u deze en installeert u de AIPService-module.If you have the older module installed, uninstall it and then install the AIPService module.

De nieuwere module heeft aliassen voor de namen van de cmdlets in de oudere module, zodat eventuele bestaande scripts blijven werken.The newer module has aliases to the cmdlet names in the older module so that any existing scripts will continue to work. Het is echter van plan om deze verwijzingen bij te werken voordat de oude module niet meer wordt ondersteund.However, plan to update these references before the old module falls out of support. De ondersteuning voor de AADRM-module loopt 15 juli 2020.Support for the AADRM module will end July 15, 2020.

Als u de AADRM-module van de PowerShell Gallery hebt geïnstalleerd, kunt u deze verwijderen door een Power shell-sessie te starten met de optie als administrator uitvoeren en typt u: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

Als u de AADRM-module met het Azure Rights Management-beheer programma hebt geïnstalleerd, gebruikt u Program ma's en onderdelen om Windows Azure AD-Rights Management beheer te verwijderen.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.

De AIPService-module installerenHow to install the AIPService module

De AIPService-module bevindt zich op de PowerShell Gallery en is niet beschikbaar in het micro soft Download centrum.The AIPService module is on the PowerShell Gallery and is not available from the Microsoft Download Center.

Zie aan de slag met de PowerShell Galleryals u nog geen ervaring hebt met de PowerShell Gallery.If you're new to the PowerShell Gallery, see Get Started with the PowerShell Gallery. Volg de instructies voor de galerie vereisten, waaronder het installeren van de PowerShellGet-module en de NuGet-provider.Follow the instructions for the gallery requirements, which include installing the PowerShellGet module and the NuGet provider.

Ga naar de pagina AIPServicevoor meer informatie over de AIPService-module op de PowerShell Gallery.To see details about the AIPService module on the PowerShell Gallery, visit the AIPService page.

Als u de AIPService-module wilt installeren, start u een Power shell-sessie met de optie als administrator uitvoeren en typt u:To install the AIPService module, start a PowerShell session with the Run as Administrator option, and type:

Install-Module -Name AIPService

Als u wordt gewaarschuwd als u een niet-vertrouwde opslag plaats installeert, kunt u op Y drukken om te bevestigen.If you are warned about installing from an untrusted repository, you can press Y to confirm. Of druk op N en configureer de PowerShell Gallery als een vertrouwde opslag plaats met behulp van de opdracht Set-PSRepository -Name PSGallery -InstallationPolicy Trusted en voer de opdracht opnieuw uit om de AIPService-module te installeren.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.

Als er een eerdere versie van de AIPService-module is geïnstalleerd uit de galerie, werkt u deze als volgt bij door te typen: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

Volgende stappenNext steps

Bevestig in een Windows Power shell-sessie de versie van de geïnstalleerde module.In a Windows PowerShell session, confirm the version of the installed module. Deze controle is met name belangrijk als u een upgrade hebt uitgevoerd van een oudere versie:This check is particularly important if you upgraded from an older version:

(Get-Module AIPService –ListAvailable).Version

Notitie

Als deze opdracht mislukt, voert u eerst import-module AIPService uit.If this command fails, first run Import-Module AIPService.

Als u wilt zien welke cmdlets beschikbaar zijn, typt u het volgende:To see which cmdlets are available, type the following:

Get-Command -Module AIPService

Gebruik de opdracht Get-Help <cmdlet_name> om de Help voor een specifieke cmdlet te bekijken en de -online parameter te gebruiken om de meest recente hulpinformatie op de website met Microsoft-documentatie te bekijken.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. Bijvoorbeeld:For example:

Get-Help Connect-AipService -online

Voor meer informatie:For more information:

Voordat u opdrachten kunt uitvoeren voor het configureren van de beveiligings service, moet u verbinding maken met de service via de cmdlet 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.

Wanneer u klaar bent met het uitvoeren van uw configuratie opdrachten, als best practice, verbreekt u de verbinding met de service met behulp van de cmdlet Disconnect-AipService .When you have finished running your configuration commands, as a best practice, disconnect from the service by using the Disconnect-AipService cmdlet. Als u de verbinding niet verbreekt, wordt deze automatisch verbroken na een periode van inactiviteit.If you do not disconnect, the connection is automatically disconnected after a period of inactivity. Hierdoor moet u soms wellicht opnieuw verbinding maken tijdens een PowerShell-sessie.Because of the automatic disconnection behavior, you might find that you need to occasionally reconnect in a PowerShell session.

Notitie

Als de beveiligings service nog niet is geactiveerd, kunt u dit doen nadat u verbinding hebt gemaakt met de service, met behulp van de cmdlet 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.