Instalowanie modułu AIPService programu PowerShell

Skorzystaj z poniższych informacji, aby ułatwić zainstalowanie modułu Windows PowerShell dla usługi ochrony z usługi 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 usługi 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ą z usługi 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 usługi Azure Information Protection.

Wymaganie Więcej informacji
Minimalna wersja Windows PowerShell Wersja 3.0

Możesz potwierdzić wersję Windows PowerShell, która jest uruchomiona, wpisując polecenie $PSVersionTable w sesji programu PowerShell. Jeśli musisz zainstalować nowszą wersję programu Windows PowerShell, zobacz Upgrading existing Windows PowerShell (Uaktualnianie istniejącego programu Windows PowerShell).

Należy pamiętać, że moduł AIPService programu PowerShell obsługuje tylko Windows PowerShell. Program PowerShell 7 nie jest obsługiwany.
Minimalna wersja .NET Framework firmy Microsoft Wersja 4.6.2

Uwaga: ta wersja .NET Framework firmy Microsoft 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 .NET Framework firmy Microsoft nie jest jeszcze zainstalowana, możesz pobrać program Microsoft .NET Framework 4.6.2. Ta minimalna wersja .NET Framework firmy Microsoft jest wymagana dla niektórych klas używanych przez moduł AIPService.
Wymagana licencja Aby korzystać z tej funkcji, musisz mieć licencję produktu. Aby uzyskać więcej informacji, zobacz Wskazówki dotyczące licencjonowania platformy Microsoft 365 dotyczące zgodności z zabezpieczeniami & — Opisy usług.

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.

Nowszy moduł zawiera aliasy nazw poleceń cmdlet w starszym module, dzięki czemu wszystkie istniejące skrypty będą nadal działać. Jednak należy zaplanować aktualizację tych odwołań, zanim stary moduł nie będzie obsługiwał. 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 programów i funkcji, aby odinstalować usługę 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 dopiero zaczynasz korzystać z Galeria programu PowerShell, zobacz Wprowadzenie do Galeria programu PowerShell. Postępuj zgodnie z instrukcjami dotyczącymi wymagań dotyczących galerii, które obejmują instalowanie modułu PowerShellGet i dostawcy NuGet.

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

Aby zainstalować moduł AIPService, uruchom sesję programu PowerShell z opcją Uruchom jako administrator i wpisz:

Install-Module -Name AIPService

Jeśli zostanie wyświetlone ostrzeżenie dotyczące instalowania 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 Set-PSRepository -Name PSGallery -InstallationPolicy Trusted , a następnie ponownie uruchomić polecenie, aby zainstalować moduł AIPService.

Jeśli masz poprzednią wersję modułu AIPService zainstalowanego 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 zakończy się niepowodzeniem, 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. Przykład:

Get-Help Connect-AipService -online

Więcej informacji:

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

Po zakończeniu uruchamiania poleceń konfiguracji należy odłączyć się od usługi za pomocą 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 nawiązaniu połączenia z usługą za pomocą polecenia cmdlet Enable-AipService .