De AIPService PowerShell-module installeren

  • Artikel

Gebruik de volgende informatie om de Windows PowerShell-module voor de beveiligingsservice van Azure Information Protection te installeren. 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 in de volgende sectie worden vermeld. Windows PowerShell voor Azure Information Protection ondersteunt scripting voor automatisering of is mogelijk nodig voor geavanceerde configuratiescenario's. Zie Beheer istering protection 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 bevestigen die u uitvoert 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 ondersteunt alleen Windows PowerShell. PowerShell 7 wordt niet ondersteund.
Minimale versie van Microsoft .NET Framework Versie 4.8

Opmerking: deze versie van 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 Microsoft .NET Framework nog niet is geïnstalleerd, kunt u Microsoft .NET Framework 4.8 downloaden. Deze minimale versie van Microsoft .NET Framework is vereist voor een aantal 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 beveiliging en naleving - 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 de PowerShell Gallery, start u een PowerShell-sessie met de optie Uitvoeren als Beheer istrator en typt u:

Uninstall-Module -Name AADRM

Als u de AADRM-module hebt geïnstalleerd met het Hulpprogramma voor Beheer beheer van Azure Rights Management, gebruikt u Programma's en onderdelen om Windows Azure AD Rights Management te verwijderen Beheer istration.

De AIPService-module installeren

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

Zie Aan de slag met de PowerShell Gallery als u nog geen toegang hebt tot de PowerShell-galerie. 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 AIPService-module in de PowerShell Gallery.

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

Install-Module -Name AIPService

Als u wordt gewaarschuwd voor 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 het nieuwste 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 Get-Help <cmdlet_name> opdracht om de Help voor een specifieke cmdlet te bekijken en gebruik de parameter -online om de meest recente Help op de microsoft-documentatiesite te bekijken. Voorbeeld:

Get-Help Connect-AipService -online

Zie voor meer informatie

Voordat u opdrachten kunt uitvoeren die de beveiligingsservice configureren, moet u verbinding maken met de service met behulp van de cmdlet Verbinding maken-AipService.

Wanneer u klaar bent met het uitvoeren van uw configuratieopdrachten, als best practice, verbreekt u de verbinding met de service met behulp van de cmdlet Disconnect-AipService . Als u de verbinding niet verbreekt, wordt de verbinding automatisch verbroken na een periode van inactiviteit. Vanwege het gedrag van automatische verbroken verbinding kan het zijn dat u af en toe opnieuw verbinding moet maken in 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 .