De PowerShell-module AIPService installeren

Gebruik de volgende informatie om de Windows PowerShell-module te installeren voor de beveiligingsservice van Azure Information Protection. De naam van deze module is AIPService en vervangt de vorige versie met de naam AADRM.

U kunt deze PowerShell-module gebruiken om de beveiligingsservice (Azure Rights Management) vanaf de opdrachtregel te beheren met behulp van een Windows-computer met een internetverbinding en die voldoet aan de vereisten die worden vermeld in de volgende sectie. Windows PowerShell voor Azure Information Protection ondersteunt scripts voor automatisering of mogelijk nodig zijn voor geavanceerde configuratiescenario's. Zie Beheerbeveiliging van Azure Information Protection met behulp van PowerShell voor meer informatie over de beheertaken en configuraties die door de module worden ondersteund.

Vereisten

Deze tabel bevat de vereisten voor het installeren en gebruiken van de AIPService PowerShell-module voor de beveiligingsservice van Azure Information Protection.

Vereiste Meer informatie
Minimale versie van Windows PowerShell Versie 3.0

U kunt de versie van Windows PowerShell die u uitvoert bevestigen door in een PowerShell-sessie te typen$PSVersionTable. 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.

Let op de AIPService PowerShell-module biedt alleen ondersteuning voor Windows PowerShell. PowerShell 7 wordt niet ondersteund.
Minimale versie van de Microsoft-.NET Framework Versie 4.5

Opmerking: deze versie van de Microsoft-.NET Framework is opgenomen in de latere besturingssystemen, dus u moet deze alleen handmatig installeren als uw clientbesturingssysteem kleiner is dan Windows 8.0 of uw serverbesturingssysteem kleiner is dan Windows Server 2012.

Als de minimale versie van de Microsoft-.NET Framework nog niet is geïnstalleerd, kunt u Microsoft .NET Framework 4.5 downloaden. Deze minimale versie van de Microsoft-.NET Framework is vereist voor sommige klassen die door de AIPService-module worden gebruikt.
Vereiste licentie U moet een productlicentie hebben om deze functie te kunnen gebruiken. Zie Microsoft 365-licentierichtlijnen voor beveiligingsnaleving & - Servicebeschrijvingen voor meer informatie.

Als u de AADRM-module hebt geïnstalleerd

De AIPService-module vervangt de oudere module, AADRM. Als u de oudere module hebt geïnstalleerd, verwijdert u deze en installeert u de AIPService-module.

De nieuwere module bevat aliassen voor de cmdlet-namen in de oudere module, zodat bestaande scripts blijven werken. Plan deze verwijzingen echter bij te werken voordat de oude module niet meer wordt ondersteund. Ondersteuning voor de AADRM-module eindigt op 15 juli 2020.

Als u de AADRM-module hebt geïnstalleerd vanuit het PowerShell Gallery, start u een PowerShell-sessie met de optie Uitvoeren als administrator en typt u:

Uninstall-Module -Name AADRM

Als u de AADRM-module hebt geïnstalleerd met het Azure Rights Management Administration Tool, gebruikt u Programma's en onderdelen om Windows Azure AD Rights Management Administration te verwijderen.

De AIPService-module installeren

De module AIPService bevindt zich op de PowerShell Gallery en is niet beschikbaar via het Microsoft Downloadcentrum.

Zie Aan de slag met de PowerShell Gallery als u geen toegang hebt tot de PowerShell Gallery. Volg de instructies voor de galerievereisten, waaronder het installeren van de PowerShellGet-module en de NuGet-provider.

Ga naar de pagina AIPService voor meer informatie over de module AIPService op de PowerShell Gallery.

Als u de AIPService-module wilt installeren, start u een PowerShell-sessie met de optie Uitvoeren als administrator en typt u:

Install-Module -Name AIPService

Als u wordt gewaarschuwd voor de installatie vanuit een niet-vertrouwde opslagplaats, kunt u op Y drukken om te bevestigen. Of druk op N en configureer de PowerShell Gallery als een vertrouwde opslagplaats met behulp van de opdracht Set-PSRepository -Name PSGallery -InstallationPolicy Trusted en voer de opdracht vervolgens opnieuw uit om de AIPService-module te installeren.

Als u een eerdere versie van de AIPService-module hebt geïnstalleerd vanuit de galerie, werkt u deze bij naar de meest recente door het volgende te typen:

Update-Module -Name AIPService

Volgende stappen

Bevestig in een Windows PowerShell sessie de versie van de geïnstalleerde module. Deze controle is met name belangrijk als u een upgrade hebt uitgevoerd van een oudere versie:

(Get-Module AIPService –ListAvailable).Version

Notitie

Als deze opdracht mislukt, voert u eerst Import-Module AIPService uit.

Als u wilt zien welke cmdlets beschikbaar zijn, typt u het volgende:

Get-Command -Module AIPService

Gebruik de opdracht Get-Help <cmdlet_name> om de Help voor een specifieke cmdlet te bekijken en de -onlineparameter te gebruiken om de meest recente hulpinformatie op de website met Microsoft-documentatie te bekijken. Bijvoorbeeld:

Get-Help Connect-AipService -online

Voor meer informatie:

Voordat u opdrachten kunt uitvoeren waarmee de beveiligingsservice wordt geconfigureerd, moet u verbinding maken met de service met behulp van de Cmdlet Connect-AipService .

Wanneer u klaar bent met het uitvoeren van uw configuratieopdrachten, kunt u het beste de verbinding met de service verbreken met behulp van de cmdlet Disconnect-AipService . Als u de verbinding niet verbreekt, wordt deze automatisch verbroken na een periode van inactiviteit. Hierdoor moet u soms wellicht opnieuw verbinding maken tijdens een PowerShell-sessie.

Notitie

Als de beveiligingsservice nog niet is geactiveerd, kunt u dit doen nadat u verbinding hebt gemaakt met de service met behulp van de cmdlet Enable-AipService .