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

Установка модуля PowerShell AIPService для службы Azure Right Management

Используйте следующие сведения, чтобы установить модуль Windows PowerShell для службы шифрования Azure Right Management с Защита информации Microsoft Purview. Этот модуль называется AIPService и заменяет предыдущую версию с именем AADRM.

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

Предварительные условия

В этой таблице перечислены предварительные требования для установки и использования модуля AIPService PowerShell для службы шифрования Azure Rights Management.

Требования Дополнительные сведения
Минимальная версия 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 входит в состав более поздних операционных систем, но если она еще не установлена, вы можете скачать Microsoft платформа .NET Framework 4.8. Эта минимальная версия microsoft платформа .NET Framework требуется для некоторых классов, которые использует модуль AIPService.
Требуемая лицензия Для использования этой функции у вас должна быть лицензия на продукт. Дополнительные сведения см. в статье Руководство по лицензированию Microsoft 365 по обеспечению соответствия требованиям безопасности & — описания служб.

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

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

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

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

Uninstall-Module -Name AADRM

Если вы установили модуль AADRM с помощью средства администрирования Azure Rights Management, используйте процедуры удаления приложений Windows, чтобы удалить Windows Azure AD Управление правами.

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

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

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

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

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

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

Примечание.

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

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

Get-Command -Module AIPService

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

Get-Help Connect-AipService -online

Подробнее:

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

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

Примечание.

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

  • Last updated on