Installera PowerShell-modulen för AIPServiceInstalling the AIPService PowerShell module

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

Använd följande information för att hjälpa dig att installera Windows PowerShell-modulen för skydds tjänsten från Azure Information Protection.Use the following information to help you install the Windows PowerShell module for the protection service from Azure Information Protection. Namnet på den här modulen är AIPService och den ersätter den tidigare versionen som har namnet AADRM.The name of this module is AIPService, and it replaces the previous version that was named AADRM.

Du kan använda den här PowerShell-modulen för att administrera skydds tjänsten (Azure Rights Management) från kommando raden med hjälp av en Windows-dator som har en Internet anslutning och som uppfyller de krav som anges i nästa avsnitt.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 PowerShell för Azure Information Protection stöder skript för Automation eller kan vara nödvändigt för avancerade konfigurations scenarier.Windows PowerShell for Azure Information Protection supports scripting for automation or might be necessary for advanced configuration scenarios. Mer information om de administrations uppgifter och konfigurationer som modulen stöder finns i Administrera skydd från Azure information Protection med hjälp av PowerShell.For more information about the administration tasks and configurations that the module supports, see Administering protection from Azure Information Protection by using PowerShell.

FörutsättningarPrerequisites

Den här tabellen innehåller förutsättningarna för att installera och använda AIPService PowerShell-modulen för skydds tjänsten från Azure Information Protection.This table lists the prerequisites to install and use the AIPService PowerShell module for the protection service from Azure Information Protection.

KravRequirement Mer informationMore information
Lägsta version av Windows PowerShell: 3,0Minimum version of Windows PowerShell: 3.0 Du kan kontrol lera vilken version av Windows PowerShell som körs genom att skriva $PSVersionTable i en PowerShell-session.You can confirm the version of Windows PowerShell that you are running by typing $PSVersionTable in a PowerShell session.

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.If you need to install a later version of Windows PowerShell, see Upgrading existing Windows PowerShell.
Minsta version av Microsoft .NET Framework: 4.5Minimum version of the Microsoft .NET Framework: 4.5

Obs! Den här versionen av Microsoft .NET Framework ingår i senare operativsystem, så du behöver antagligen bara installera den manuellt om du har ett äldre klientoperativsystem än Windows 8.0 eller om ditt serveroperativsystem är äldre än 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.
Om den minsta versionen av Microsoft .NET Framework inte redan är installerad kan du ladda ned Microsoft .NET Framework 4,5.If the minimum version of the Microsoft .NET Framework is not already installed, you can download Microsoft .NET Framework 4.5.

Den här lägsta versionen av Microsoft .NET Framework krävs för några av klasserna som AIPService-modulen använder.This minimum version of the Microsoft .NET Framework is required for some of the classes that the AIPService module uses.

Om du har installerat AADRM-modulenIf you have the AADRM module installed

AIPService-modulen ersätter den äldre modulen, AADRM.The AIPService module replaces the older module, AADRM. Om du har installerat den äldre modulen avinstallerar du den och installerar AIPService-modulen.If you have the older module installed, uninstall it and then install the AIPService module.

Den nyare modulen har alias till cmdlet-namnen i den äldre modulen så att alla befintliga skript fortsätter att fungera.The newer module has aliases to the cmdlet names in the older module so that any existing scripts will continue to work. Men planera att uppdatera de här referenserna innan den gamla modulen faller utanför supporten.However, plan to update these references before the old module falls out of support. Support för AADRM-modulen upphör 15 juli 2020.Support for the AADRM module will end July 15, 2020.

Om du har installerat AADRM-modulen från PowerShell-galleriet kan du avinstallera den genom att starta en PowerShell-session med alternativet Kör som administratör och skriva: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

Om du har installerat AADRM-modulen med Azure Rights Management administrations verktyg använder du program och funktioner för att avinstallera Windows Azure AD Rights Management administration.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.

Så här installerar du AIPService-modulenHow to install the AIPService module

AIPService-modulen finns på PowerShell-galleriet och är inte tillgänglig från Microsoft Download Center.The AIPService module is on the PowerShell Gallery and is not available from the Microsoft Download Center.

Om du är nybörjare på PowerShell-galleriet, se Kom igång med PowerShell-galleriet.If you're new to the PowerShell Gallery, see Get Started with the PowerShell Gallery. Följ instruktionerna för Galleri kraven, som inkluderar installation av PowerShellGet-modulen och NuGet-providern.Follow the instructions for the gallery requirements, which include installing the PowerShellGet module and the NuGet provider.

Om du vill se information om AIPService-modulen på PowerShell-galleriet går du till sidan AIPService.To see details about the AIPService module on the PowerShell Gallery, visit the AIPService page.

Du installerar AIPService-modulen genom att starta en PowerShell-session med alternativet Kör som administratör och skriva:To install the AIPService module, start a PowerShell session with the Run as Administrator option, and type:

Install-Module -Name AIPService

Om du varnas om att installera från ett ej betrott lager kan du trycka på j för att bekräfta.If you are warned about installing from an untrusted repository, you can press Y to confirm. Eller tryck på N och konfigurera PowerShell-galleriet som ett betrott lager med hjälp av kommandot Set-PSRepository -Name PSGallery -InstallationPolicy Trusted och kör sedan kommandot för att installera AIPService-modulen.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.

Om du har en tidigare version av AIPService-modulen installerad från galleriet uppdaterar du den med den senaste genom att skriva: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

Nästa stegNext steps

I en Windows PowerShell-session bekräftar du versionen av den installerade modulen.In a Windows PowerShell session, confirm the version of the installed module. Den här kontrollen är särskilt viktig om du har uppgraderat från en äldre version:This check is particularly important if you upgraded from an older version:

(Get-Module AIPService –ListAvailable).Version

Anteckning

Om det här kommandot Miss lyckas kör du först import-module AIPService.If this command fails, first run Import-Module AIPService.

Om du vill se vilka cmdletar som är tillgängliga skriver du följande:To see which cmdlets are available, type the following:

Get-Command -Module AIPService

Använd kommandot Get-Help <cmdlet_name> 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 dokumentationsplats.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. Exempel:For example:

Get-Help Connect-AipService -online

Mer information:For more information:

Innan du kan köra kommandon som konfigurerar skydds tjänsten måste du ansluta till tjänsten med hjälp av cmdleten 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.

När du är färdig med konfigurations kommandona kan du koppla från tjänsten med hjälp av cmdleten disconnect-AipService .When you have finished running your configuration commands, as a best practice, disconnect from the service by using the Disconnect-AipService cmdlet. Om du inte kopplas ifrån, kopplas anslutningen automatiskt ifrån efter en tids inaktivitet.If you do not disconnect, the connection is automatically disconnected after a period of inactivity. Funktionen för automatisk frånkoppling kan innebära att du ibland behöver återansluta i en PowerShell-session.Because of the automatic disconnection behavior, you might find that you need to occasionally reconnect in a PowerShell session.

Anteckning

Om skydds tjänsten inte har Aktiver ATS än kan du göra det när du har anslutit till tjänsten med hjälp av cmdleten 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.