Instalowanie modułu AIPService programu PowerShell

  • Artykuł

Skorzystaj z poniższych informacji, aby ułatwić zainstalowanie modułu programu 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.

Za pomocą tego modułu programu PowerShell można administrować 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 który spełnia wymagania wstępne wymienione w następnej sekcji. Program Windows PowerShell dla usługi Azure Information Protection obsługuje wykonywanie skryptów w celu 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 Administracja istering protection from Azure Information Protection by using PowerShell (Ochrona przed usługą 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 programu Windows PowerShell Wersja 3.0

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

Zwróć uwagę, że moduł AIPService programu PowerShell obsługuje tylko program Windows PowerShell. Program PowerShell 7 nie jest obsługiwany.
Minimalna wersja programu Microsoft .NET Framework Wersja 4.8

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.8. Ta minimalna wersja programu Microsoft .NET Framework 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 zabezpieczeń i zgodności — 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 zaplanuj 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 Administracja istrator i wpisz:

Uninstall-Module -Name AADRM

Jeśli zainstalowano moduł AADRM z narzędziem azure Rights Management Administracja istration Tool, użyj programów i funkcji, aby odinstalować Administracja istration usługi Windows Azure AD Rights Management.

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 w Galeria programu PowerShell, odwiedź stronę AIPService.

Aby zainstalować moduł AIPService, uruchom sesję programu PowerShell z opcją Uruchom jako Administracja istrator 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ąć przycisk 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, wpisując:

Update-Module -Name AIPService

Następne kroki

W sesji programu Windows PowerShell potwierdź wersję zainstalowanego modułu. Ta kontrola jest szczególnie ważna w przypadku 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 sprawdzić, które polecenia cmdlet są dostępne, wpisz następujące polecenie:

Get-Command -Module AIPService

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

Get-Help Connect-AipService -online

Więcej informacji można znaleźć na stronie

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

Po zakończeniu uruchamiania poleceń konfiguracji należy odłączyć się od usługi za pomocą polecenia cmdlet Disconnect-AipService . Jeśli połączenie nie zostanie rozłączone, zostanie automatycznie rozłączone po upływie okresu braku aktywności. Ze względu na zachowanie automatycznego rozłączania może się okazać, że trzeba od czasu do czasu ponownie nawiązać połączenie w 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 .