Installera AIPService PowerShell-modulen

Gäller för:Azure Information Protection, Office 365

Relevant för:AIP unified labeling client and classic client

Obs!

För att ge en enhetlig och smidig kundupplevelse är den klassiska Azure Information Protection-klienten och Etiketthantering i Azure-portalen inaktuella sedan den 31 mars 2021. Inget ytterligare stöd tillhandahålls för den klassiska klienten och underhållsversioner kommer inte längre att släppas.

Den klassiska klienten upphör officiellt och slutar fungera den 31 mars 2022.

Alla aktuella kunder med Azure Information Protection för klassiska klienter måste migrera till Microsoft Information Protection unified labeling-plattformen och uppgradera till den enhetliga etikettklienten. Läs mer i vår migreringsblogg.

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

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

Krav

I den här tabellen finns en lista över förutsättningarna 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 kör genom att skriva $PSVersionTable i en PowerShell-session. Om du behöver installera en senare version av Windows PowerShell finns mer information i Uppgradera befintliga Windows PowerShell.
Lägsta version av Microsoft-.NET Framework Version 4.5

Obs!Den här versionen av Microsoft .NET Framework ingår i senare operativsystem, så du bör endast behöva installera den manuellt om klientoperativsystemet är mindre än Windows 8.0 eller om operativsystemet ä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.5. Den här minimiversionen av Microsoft.NET Framework versionen krävs för vissa av klasserna som AIPService-modulen använder.
Obligatorisk licens Du måste ha en produktlicens för att använda den här funktionen. Mer information finns i vägledningen Microsoft 365 om licensiering för säkerhetsefterlevnad – Tjänstbeskrivningar.

Om du har AADRM-modulen installerad

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 för cmdlet-namn i den äldre modulen så att befintliga skript fortsätter att fungera. Men planera att uppdatera de här referenserna innan den gamla modulen faller från supporten. Stödet för AADRM-modulen slutar 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 för att avinstallera det och skriver:

Uninstall-Module -Name AADRM

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

Så här installerar du AIPService-modulen

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

Om du inte har tittat på PowerShell-galleriet för första Kom igång med PowerShell-galleriet. Följ anvisningarna för gallerikraven, vilket omfattar installation av PowerShellGet-modulen och NuGet-providern.

Om du vill se information om AIPService-modulen i PowerShell-galleriet går du till AIPService-sidan.

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 icke betrodd lagringsplats kan du trycka på Y för att bekräfta. Eller tryck på N och konfigurera PowerShell-galleriet som en betrodd lagringsplats med kommandot och kör sedan kommandot igen för att installera Set-PSRepository -Name PSGallery -InstallationPolicy Trusted 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

Obs!

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

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

Get-Command -Module AIPService

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

Get-Help Connect-AipService -online

Mer information:

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

När du har kört konfigurationskommandona är det bäst att koppla bort tjänsten med cmdleten Disconnect-AipService. Om du inte kopplar från kopplas anslutningen från automatiskt efter en tid av inaktivitet. På grund av den automatiska nedkopplingen kan du behöva ibland återansluta i en PowerShell-session.

Obs!

Om skyddstjänsten ännu inte är aktiverad kan du göra det när du har anslutit till tjänsten med hjälp av cmdleten Enable-AipService.