Installera AIPService PowerShell-modulen

Artikel
10/18/2023

Använd följande information för att installera Windows PowerShell-modulen för skyddstjänsten från Azure Information Protection. Namnet på den här modulen är AIPService och ersätter den tidigare versionen med namnet AADRM.

Du kan använda den här PowerShell-modulen för att administrera skyddstjänsten (Azure Rights Management) från kommandoraden med hjälp av alla Windows-datorer som har en Internetanslutning och som uppfyller de krav som anges i nästa avsnitt. Windows PowerShell för Azure Information Protection stöder skript för automatisering eller kan vara nödvändigt för avancerade konfigurationsscenarier. Mer information om administrationsuppgifter och konfigurationer som modulen stöder finns i Administrera skydd från Azure Information Protection med hjälp av PowerShell.

Förutsättningar

I den här tabellen visas kraven för att installera och använda AIPService PowerShell-modulen för skyddstjänsten från Azure Information Protection.

Krav	Mer information
Lägsta version av Windows PowerShell	Version 3.0 Du kan bekräfta vilken version av Windows PowerShell du kör genom att skriva in en PowerShell-session `$PSVersionTable` . Om du behöver installera en senare version av Windows PowerShell kan du läsa informationen om att uppgradera en befintlig version av Windows PowerShell. Observera att PowerShell-modulen AIPService endast stöder Windows PowerShell. PowerShell 7 stöds inte.
Lägsta version av Microsoft .NET Framework	Version 4.8 Obs! Den här versionen av Microsoft .NET Framework ingår i de senare operativsystemen, så du bör bara behöva installera den manuellt om klientoperativsystemet är mindre än Windows 8.0 eller om serveroperativsystemet är mindre än Windows Server 2012. Om den lägsta versionen av Microsoft .NET Framework inte redan är installerad kan du ladda ned Microsoft .NET Framework 4.8. Den här lägsta versionen av Microsoft .NET Framework krävs för vissa av de klasser som AIPService-modulen använder.
Nödvändig licens	Du måste ha en produktlicens för att kunna använda den här funktionen. Mer information finns i Microsoft 365-licensieringsvägledning för säkerhet och efterlevnad – Tjänstbeskrivningar.

Om du har installerat AADRM-modulen

AIPService-modulen ersätter den äldre modulen AADRM. Om du har den äldre modulen installerad avinstallerar du den och installerar sedan AIPService-modulen.

Den nyare modulen har alias till cmdlet-namnen i den äldre modulen så att alla befintliga skript fortsätter att fungera. Planera dock att uppdatera dessa referenser innan den gamla modulen inte stöds. Stöd för AADRM-modulen upphör den 15 juli 2020.

Om du har installerat AADRM-modulen från PowerShell-galleriet startar du en PowerShell-session med alternativet Kör som administratör och skriver:

Uninstall-Module -Name AADRM

Om du har installerat AADRM-modulen med Administrationsverktyget för Azure Rights Management använder du Program och funktioner för att avinstallera Windows Azure AD Rights Management Administration.

Installera AIPService-modulen

AIPService-modulen finns på PowerShell-galleriet och är inte tillgänglig från Microsoft Download Center.

Så här installerar du AIPService-modulen från PowerShell-galleriet

Om du inte har använt PowerShell-galleriet tidigare kan du läsa Kom igång med PowerShell-galleriet. Följ anvisningarna för gallerikraven, som omfattar installation av PowerShellGet-modulen och NuGet-providern.

Mer information om AIPService-modulen på PowerShell-galleriet finns på sidan AIPService.

Om du vill installera AIPService-modulen startar du en PowerShell-session med alternativet Kör som administratör och skriver:

Install-Module -Name AIPService

Om du får en varning om att installera från en obetrodd lagringsplats kan du trycka på Y för att bekräfta. Eller tryck på N och konfigurera PowerShell-galleriet som en betrodd lagringsplats med hjälp av kommandot Set-PSRepository -Name PSGallery -InstallationPolicy Trusted och kör sedan kommandot igen för att installera AIPService-modulen.

Om du har en tidigare version av AIPService-modulen installerad från galleriet uppdaterar du den till den senaste genom att skriva:

Update-Module -Name AIPService

Nästa steg

I en Windows PowerShell-session bekräftar du versionen av den installerade modulen. Den här kontrollen är särskilt viktig om du har uppgraderat från en äldre version:

(Get-Module AIPService –ListAvailable).Version

Kommentar

Om det här kommandot misslyckas kör du först Import-Module AIPService.

Om du vill se vilka cmdletar som är tillgängliga skriver du följande:

Get-Command -Module AIPService

Get-Help <cmdlet_name> Använd kommandot för att se hjälpen för en specifik cmdlet och använd parametern -online för att se den senaste hjälpen på Microsofts dokumentationswebbplats. Till exempel:

Get-Help Connect-AipService -online

Mer information:

Fullständig lista över tillgängliga cmdletar: AIPService-modul
Lista över huvudkonfigurationsscenarier som stöder PowerShell: Administrera skydd från Azure Information Protection med hjälp av PowerShell

Innan du kan köra kommandon som konfigurerar skyddstjänsten måste du ansluta till tjänsten med hjälp av cmdleten Anslut-AipService.

När du har kört konfigurationskommandona är det bästa praxis att koppla från tjänsten med hjälp av cmdleten Disconnect-AipService . Om du inte kopplar från kopplas anslutningen automatiskt från efter en period av inaktivitet. På grund av det automatiska frånkopplingsbeteendet kan det hända att du ibland behöver återansluta i en PowerShell-session.