Установка PowerShell-модуля AIPService

Статья
10/18/2023

Используйте следующие сведения, чтобы установить модуль Windows PowerShell для службы защиты из Azure Information Protection. Имя этого модуля — AIPService и заменяет предыдущую версию, которая была названа AADRM.

Этот модуль PowerShell можно использовать для администрирования службы защиты (Azure Rights Management) из командной строки с помощью любого компьютера Windows, имеющего подключение к Интернету, и соответствующего предварительным требованиям, перечисленным в следующем разделе. Windows PowerShell для Azure Information Protection поддерживает скрипты для автоматизации или может потребоваться для расширенных сценариев конфигурации. Дополнительные сведения о задачах и конфигурациях администрирования, поддерживаемых модулем, см. в разделе Администратор защиты от Azure Information Protection с помощью PowerShell.

Необходимые компоненты

В этой таблице перечислены необходимые условия для установки и использования модуля AIPService PowerShell для службы защиты от Azure Information Protection.

Требование	Дополнительные сведения
Минимальная версия Windows PowerShell	Версия 3.0 Вы можете подтвердить версию Windows PowerShell, которую вы используете, введя `$PSVersionTable` в сеанс PowerShell. Если вам нужно установить более позднюю версию Windows PowerShell, см. раздел Обновление существующей версии Windows PowerShell. Обратите внимание, что модуль PowerShell AIPService поддерживает только Windows PowerShell. PowerShell 7 не поддерживается.
Минимальная версия Microsoft платформа .NET Framework	Версия 4.8 Примечание. Эта версия Microsoft платформа .NET Framework входит в состав более поздних операционных систем, поэтому ее необходимо установить вручную, только если операционная система клиента меньше Windows 8.0 или операционная система сервера меньше Windows Server 2012. Если минимальная версия Microsoft платформа .NET Framework еще не установлена, вы можете скачать microsoft платформа .NET Framework 4.8. Эта минимальная версия Microsoft платформа .NET Framework требуется для некоторых классов, которые использует модуль AIPService.
Требуемая лицензия	Для использования этой функции необходимо иметь лицензию на продукт. Дополнительные сведения см . в руководстве по лицензированию Microsoft 365 по безопасности и соответствию требованиям — описания службы.

Если у вас установлен модуль AADRM

Модуль AIPService заменяет старый модуль AADRM. Если у вас установлен старый модуль, удалите его и установите модуль AIPService.

Новый модуль имеет псевдонимы для имен командлетов в более старом модуле, чтобы все существующие скрипты продолжали работать. Однако планируйте обновление этих ссылок до того, как старый модуль не поддерживается. Поддержка модуля AADRM завершится 15 июля 2020 г.

Если вы установили модуль AADRM из коллекция PowerShell, чтобы удалить его, запустите сеанс PowerShell с параметром Запуска от имени Администратор istrator и введите:

Uninstall-Module -Name AADRM

Если вы установили модуль AADRM с помощью средства управления правами Azure Администратор istration, используйте программы и компоненты для удаления Администратор управления правами Windows Azure AD.

Установка модуля AIPService

Модуль AIPService находится в коллекция PowerShell и недоступен в Центре загрузки Майкрософт.

Установка модуля AIPService из коллекция PowerShell

Если вы не знакомы с коллекция PowerShell, см. статью "Начало работы с коллекция PowerShell". Следуйте инструкциям по требованиям к коллекции, которые включают установку модуля PowerShellGet и поставщика NuGet.

Чтобы просмотреть сведения о модуле AIPService на коллекция PowerShell, перейдите на страницу AIPService.

Чтобы установить модуль AIPService, запустите сеанс PowerShell с параметром запуска от имени Администратор istrator и введите:

Install-Module -Name AIPService

Если вы предупреждаете об установке из ненадежного репозитория, нажмите клавишу Y, чтобы подтвердить. Или нажмите клавишу N и настройте коллекция PowerShell в качестве доверенного репозитория с помощью команды, а затем повторно выполните командуSet-PSRepository -Name PSGallery -InstallationPolicy Trusted, чтобы установить модуль AIPService.

Если у вас установлена предыдущая версия модуля AIPService из коллекции, обновите ее до последней версии, введя следующее:

Update-Module -Name AIPService

Следующие шаги

В сеансе Windows PowerShell подтвердите версию установленного модуля. Эта проверка особенно важна при обновлении более старой версии:

(Get-Module AIPService –ListAvailable).Version

Примечание.

Если эта команда завершается ошибкой, сначала запустите AIPService import-Module.

Чтобы узнать, какие командлеты доступны, введите следующее:

Get-Command -Module AIPService

Get-Help <cmdlet_name> Используйте команду, чтобы просмотреть справку для определенного командлета и использовать параметр -online, чтобы просмотреть последнюю справку на сайте документации Майкрософт. Например:

Get-Help Connect-AipService -online

Дополнительные сведения см. по ссылке .

Полный список командлетов: модуль AIPService
Список основных сценариев конфигурации, поддерживающих PowerShell: Администратор защиты от Azure Information Protection с помощью PowerShell

Прежде чем выполнять любые команды, которые настраивают службу защиты, необходимо подключиться к службе с помощью командлета Подключение-AipService.

Завершив выполнение команд конфигурации, рекомендуется отключиться от службы с помощью командлета Disconnect-AipService . Если вы не отключаете, подключение автоматически отключается после периода бездействия. Из-за автоматического отключения может возникнуть необходимость иногда повторного подключения в сеансе PowerShell.

Примечание.

Если служба защиты еще не активирована, это можно сделать после подключения к службе с помощью командлета Enable-AipService .

Поделиться через