Instalowanie modułu AIPService programu PowerShell

Dotyczy: Azure Information Protection, Office 365

Istotne dla programu : Ujednolicony klient etykietowania usługi AIP i klient klasyczny

Uwaga

Aby zapewnić ujednolicone i usprawnione środowisko klienta, Azure Information Protection klasyczny klient i zarządzanie etykietami w witrynie Azure Portal są przestarzałe od 31 marca 2021. Mimo że klasyczny klient nadal działa zgodnie z konfiguracją, nie podano dalszej pomocy technicznej i wersje konserwacji nie będą już udostępniane dla klasycznego klienta.

Zalecamy przeprowadzenie migracji do ujednoliconej etykietowania i uaktualnienia do ujednoliconego klienta etykietowania. Więcej informacji znajdziesz w naszym blogu dotyczącym wycofania.

Poniższe informacje ułatwiają zainstalowanie modułu Windows PowerShell dla usługi ochrony z poziomu Azure Information Protection. Nazwa tego modułu to AIPService i zastępuje poprzednią wersję o nazwie AADRM.

Ten moduł programu PowerShell umożliwia administrowanie usługą ochrony (Azure Rights Management) z poziomu wiersza polecenia przy użyciu dowolnego komputera z systemem Windows, który ma połączenie z Internetem i spełnia wymagania wstępne wymienione w następnej sekcji. Windows PowerShell dla Azure Information Protection obsługuje skrypty automatyzacji lub może być konieczne w przypadku zaawansowanych scenariuszy konfiguracji. Aby uzyskać więcej informacji na temat zadań administracyjnych i konfiguracji, które obsługuje moduł, zobacz Administrowanie ochroną przed Azure Information Protection przy użyciu programu PowerShell.

Wymagania wstępne

W tej tabeli wymieniono wymagania wstępne dotyczące instalowania i używania modułu AIPService programu PowerShell dla usługi ochrony z Azure Information Protection.

Wymaganie Więcej informacji
Minimalna wersja Windows PowerShell Wersja 3.0

Możesz potwierdzić wersję Windows PowerShell, wpisując w sesji $PSVersionTable programu PowerShell. Jeśli musisz zainstalować nowszą wersję programu Windows PowerShell, zobacz Upgrading existing Windows PowerShell (Uaktualnianie istniejącego programu Windows PowerShell).
Minimalna wersja programu Microsoft .NET Framework Wersja 4.5

Uwaga: ta wersja programu Microsoft .NET Framework jest dołączona do nowszych systemów operacyjnych, dlatego należy zainstalować ją ręcznie tylko wtedy, gdy system operacyjny klienta jest mniejszy niż Windows 8.0 lub system operacyjny serwera jest mniejszy niż Windows Server 2012.

Jeśli minimalna wersja programu Microsoft .NET Framework nie jest jeszcze zainstalowana, możesz pobrać program Microsoft .NET Framework 4.5. Ta minimalna wersja pakietu Microsoft .NET Framework jest wymagana dla niektórych klas, których używa moduł AIPService.
Wymagana licencja Aby korzystać z tej funkcji, musisz mieć licencję na produkt. Aby uzyskać więcej informacji, zobacz Microsoft 365 licensing guidance for security & compliance - Service Descriptions.

Jeśli masz zainstalowany moduł AADRM

Moduł AIPService zastępuje starszy moduł AADRM. Jeśli masz zainstalowany starszy moduł, odinstaluj go, a następnie zainstaluj moduł AIPService.

Nowsza wersja modułu ma aliasy nazw cmdlet w starszym module, dzięki czemu wszystkie istniejące skrypty będą nadal działać. Należy jednak zaplanować aktualizację tych odwołań, zanim stary moduł nie będzie już obsługi. Obsługa modułu AADRM zakończy się 15 lipca 2020 r.

Jeśli moduł AADRM został zainstalowany z Galeria programu PowerShell, aby go odinstalować, uruchom sesję programu PowerShell z opcją Uruchom jako administrator i wpisz:

Uninstall-Module -Name AADRM

Jeśli moduł AADRM został zainstalowany za pomocą narzędzia Azure Rights Management Administration Tool, użyj programu Programy i funkcje, aby odinstalować program Windows Azure AD Rights Management Administration .

Jak zainstalować moduł AIPService

Moduł AIPService znajduje się na Galeria programu PowerShell i nie jest dostępny w Centrum pobierania Microsoft.

Jeśli jesteś nowym użytkownikiem tej Galeria programu PowerShell, zobacz Wprowadzenie z Galeria programu PowerShell. Postępuj zgodnie z instrukcjami dotyczącymi wymagań galerii, które obejmują instalowanie modułu PowerShellGet i NuGet dostawcy.

Aby wyświetlić szczegółowe informacje o module AIPService na stronie Galeria programu PowerShell, odwiedź stronę usługi AIPService.

Aby zainstalować moduł AIPService, uruchom sesję programu PowerShell przy użyciu opcji Uruchom jako administrator i wpisz:

Install-Module -Name AIPService

Jeśli zostanie ostrzeżenie o instalacji z niezaufanego repozytorium, możesz nacisnąć klawisz Y, aby potwierdzić. Możesz też nacisnąć N i skonfigurować Galeria programu PowerShell jako zaufane repozytorium przy użyciu polecenia , a następnie ponownie uruchomić polecenie, aby zainstalować Set-PSRepository -Name PSGallery -InstallationPolicy Trusted moduł AIPService.

Jeśli masz zainstalowaną poprzednią wersję modułu AIPService z galerii, zaktualizuj go do najnowszej wersji, wpisując:

Update-Module -Name AIPService

Następne kroki

W sesji Windows PowerShell potwierdź wersję zainstalowanego modułu. Ta czynność jest szczególnie ważna w przypadku przeprowadzenia uaktualnienia ze starszej wersji:

(Get-Module AIPService –ListAvailable).Version

Uwaga

Jeśli to polecenie nie powiedzie się, najpierw uruchom polecenie Import-Module AIPService.

Aby zobaczyć, jakie polecenia cmdlet są dostępne, wpisz następujące polecenie:

Get-Command -Module AIPService

Użyj polecenia Get-Help <cmdlet_name>, aby wyświetlić sekcję pomocy dla określonego polecenia cmdlet, i użyj parametru -online, aby wyświetlić najnowszą pomoc w witrynie dokumentacji firmy Microsoft. Na przykład:

Get-Help Connect-AipService -online

Więcej informacji:

Przed uruchomieniem jakichkolwiek poleceń, które konfigurują usługę ochrony, należy połączyć się z usługą przy użyciu polecenia cmdlet Połączenie-AipService.

Po zakończeniu uruchamiania poleceń konfiguracji najlepszym rozwiązaniem jest rozłączenie się z usługą przy użyciu polecenia cmdlet Disconnect-AipService. W przeciwnym razie połączenie zostanie automatycznie rozłączone po upływie określonego czasu braku aktywności. Ze względu na działanie funkcji automatycznego rozłączenia od czasu do czasu może okazać się konieczne ponowne nawiązanie połączenia w ramach sesji programu PowerShell.

Uwaga

Jeśli usługa ochrony nie została jeszcze aktywowana, możesz to zrobić po na połączeniu z usługą za pomocą polecenia cmdlet Enable-AipService.