Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Verwenden Sie die folgenden Informationen, um das Windows PowerShell-Modul für den Azure Right Management-Verschlüsselungsdienst von Microsoft Purview Information Protection zu installieren. Der Name dieses Moduls lautet AIPService und ersetzt die vorherige Version mit dem Namen AADRM.
Sie können dieses PowerShell-Modul verwenden, um den Azure Rights Management-Verschlüsselungsdienst über die Befehlszeile mithilfe eines beliebigen Windows-Computers zu verwalten, der über eine Internetverbindung verfügt und die im nächsten Abschnitt aufgeführten Voraussetzungen erfüllt. Windows PowerShell für Azure Rights Management unterstützt Skripts für die Automatisierung oder ist möglicherweise für erweiterte Konfigurationsszenarien erforderlich. Weitere Informationen zu den Verwaltungsaufgaben und Konfigurationen, die das Modul unterstützt, finden Sie unter Verwalten des Azure Rights Management-Diensts mithilfe von PowerShell.
Voraussetzungen
In dieser Tabelle sind die Voraussetzungen für die Installation und Verwendung des PowerShell-Moduls AIPService für den Azure Rights Management-Verschlüsselungsdienst aufgeführt.
| Anforderung | Weitere Informationen |
|---|---|
| Mindestversion von Windows PowerShell | Version 3.0 Sie können die Version von Windows PowerShell überprüfen, die Sie ausführen, indem Sie in einer PowerShell-Sitzung eingeben $PSVersionTable. Wenn Sie eine höhere Version von Windows PowerShell installieren müssen, lesen Sie Aktualisieren vorhandener Windows PowerShell. Beachten Sie, dass das PowerShell-Modul AIPService nur Windows PowerShell unterstützt. PowerShell 7 wird nicht unterstützt. |
| Mindestversion der Microsoft .NET Framework | Version 4.8 Diese Mindestversion von Microsoft .NET Framework ist in den späteren Betriebssystemen enthalten, aber wenn sie noch nicht installiert ist, können Sie Microsoft .NET Framework 4.8 herunterladen. Diese Mindestversion des Microsoft .NET Framework ist für einige der Klassen erforderlich, die das AIPService-Modul verwendet. |
| Erforderliche Lizenz | Sie benötigen eine Produktlizenz, um dieses Feature verwenden zu können. Weitere Informationen finden Sie unter Microsoft 365-Lizenzierungsleitfaden für Sicherheit & Compliance – Dienstbeschreibungen. |
Wenn Sie das AADRM-Modul installiert haben
Das AIPService-Modul ersetzt das ältere Modul AADRM. Wenn Sie das ältere Modul installiert haben, deinstallieren Sie es, und installieren Sie dann das Modul AIPService.
Das neuere Modul verfügt über Aliase für die Cmdlet-Namen im älteren Modul, sodass alle vorhandenen Skripts weiterhin funktionieren. Das alte Modul wird am 15. Juli 2020 nicht mehr unterstützt.
Wenn Sie das AADRM-Modul aus dem PowerShell-Katalog installiert haben, starten Sie zum Deinstallieren eine PowerShell-Sitzung mit der Option Als Administrator ausführen, und geben Sie Folgendes ein:
Uninstall-Module -Name AADRM
Wenn Sie das AADRM-Modul mit dem Azure Rights Management-Verwaltungstool installiert haben, verwenden Sie Ihre Windows-Verfahren zum Entfernen von Anwendungen, um Windows Azure AD Rights Management Administration zu deinstallieren.
Installieren des AIPService-Moduls
Das Modul AIPService befindet sich im PowerShell-Katalog und ist nicht im Microsoft Download Center verfügbar.
So installieren Sie das AIPService-Modul aus dem PowerShell-Katalog
Wenn Sie noch nicht mit dem PowerShell-Katalog vertraut sind, finden Sie weitere Informationen unter Erste Schritte mit dem PowerShell-Katalog. Befolgen Sie die Anweisungen für die Kataloganforderungen, einschließlich der Installation des PowerShellGet-Moduls und des NuGet-Anbieters.
Details zum AIPService-Modul auf dem PowerShell-Katalog finden Sie auf der Seite AIPService.
Um das AIPService-Modul zu installieren, starten Sie eine PowerShell-Sitzung mit der Option Als Administrator ausführen , und geben Sie Folgendes ein:
Install-Module -Name AIPService
Wenn Sie vor der Installation aus einem nicht vertrauenswürdigen Repository gewarnt werden, können Sie Y drücken, um dies zu bestätigen. Oder drücken Sie N, und konfigurieren Sie die PowerShell-Katalog mit dem Befehl Set-PSRepository -Name PSGallery -InstallationPolicy Trusted als vertrauenswürdiges Repository, und führen Sie dann den Befehl erneut aus, um das AIPService-Modul zu installieren.
Wenn Sie eine frühere Version des AIPService-Moduls aus dem Katalog installiert haben, aktualisieren Sie es auf die neueste Version, indem Sie Folgendes eingeben:
Update-Module -Name AIPService
Nächste Schritte
Überprüfen Sie in einer Windows PowerShell Sitzung die Version des installierten Moduls. Diese Überprüfung ist besonders wichtig, wenn Sie von einer älteren Version aktualisiert haben:
(Get-Module AIPService –ListAvailable).Version
Hinweis
Wenn dieser Befehl fehlschlägt, führen Sie zuerst Import-Module AIPService aus.
Geben Sie Folgendes ein, um zu sehen, welche Cmdlets verfügbar sind:
Get-Command -Module AIPService
Verwenden Sie den Get-Help <cmdlet_name> Befehl, um die Hilfe für ein bestimmtes Cmdlet anzuzeigen, und verwenden Sie den Parameter -online , um die neueste Hilfe auf der Microsoft-Dokumentationswebsite anzuzeigen. Zum Beispiel:
Get-Help Connect-AipService -online
Weitere Informationen:
Vollständige Liste der verfügbaren Cmdlets: AIPService-Modul
Liste der wichtigsten Konfigurationsszenarien, die PowerShell unterstützen: Verwalten des Azure Rights Management-Diensts mithilfe von PowerShell
Bevor Sie Befehle ausführen können, die den Azure Rights Management-Dienst konfigurieren, müssen Sie mithilfe des Cmdlets Connect-AipService eine Verbindung mit dem Dienst herstellen.
Wenn Sie die Ausführung der Konfigurationsbefehle abgeschlossen haben, sollten Sie die Verbindung mit dem Dienst mithilfe des Cmdlets Disconnect-AipService als bewährte Methode trennen. Wenn Sie die Verbindung nicht trennen, wird die Verbindung nach einer Zeit der Inaktivität automatisch getrennt. Aufgrund des Verhaltens der automatischen Trennung stellen Sie möglicherweise fest, dass Sie gelegentlich eine erneute Verbindung in einer PowerShell-Sitzung herstellen müssen.
Hinweis
Wenn der Azure Rights Management-Dienst noch nicht aktiviert ist, können Sie dies tun, nachdem Sie eine Verbindung mit dem Dienst hergestellt haben, indem Sie das Cmdlet Enable-AipService verwenden.