Установка модуля AIPService PowerShell для службы управления правами Azure

Описание службы Microsoft Purview

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

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

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

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

Требования Дополнительные сведения
Поддерживаемые версии PowerShell Windows PowerShell 5.1 или PowerShell 7.4 или более поздней версии.

Чтобы проверить используемую версию, введите $PSVersionTable текст в сеансе PowerShell. Свойство PSEdition отображается Desktop для Windows PowerShell и Core PowerShell 7. Инструкции по установке PowerShell 7 см. в статье "Установка PowerShell в Windows".

Для PowerShell 7 требуется AIPService версии 3.1.0.0 или более поздней. Более ранние версии модуля поддерживают только Windows PowerShell.
Минимальная версия .NET Для использования Windows PowerShell 5.1 требуется платформа .NET Framework 4.8.

Эта минимальная версия Microsoft платформа .NET Framework входит в состав более поздних операционных систем, но если она еще не установлена, можно скачать платформу .NET Framework 4.8. Эта минимальная версия Microsoft платформа .NET Framework требуется для некоторых классов, используемых модулем AIPService.

PowerShell 7.4 и более поздних версий включает версию .NET, необходимую модулю, поэтому отдельная установка не требуется.
Требуемая лицензия Для использования этой функции необходима лицензия на продукт. Дополнительные сведения см. в руководстве по лицензированию Microsoft 365 для обеспечения безопасности & соответствия требованиям — описания служб.

Выпуски PowerShell

AIPService версии 3.1.0.0 поддерживает оба выпуска PowerShell в Windows из одного пакета:

Издание Узел Время выполнения
Версия для настольного компьютера Windows PowerShell 5.1 .NET Framework 4.8
Ядро PowerShell 7.4 и более поздних версий .NET 8

Модуль автоматически выбирает правильный выпуск при импорте, поэтому одна и та же Install-Module команда работает на обоих хостах. Имена командлетов, параметры и выходные данные одинаковы в обоих выпусках.

Интерактивный вход в разные версии различается. Windows PowerShell 5.1 выполняет вход через встроенное веб-представление, в то время как PowerShell 7 использует веб-браузер по умолчанию и локальный адрес замыкания на себя. На компьютере без браузера по умолчанию, например на компьютере с установленными основными серверными компонентами, или в удаленном сеансе, используйте проверку подлинности на основе сертификатов или субъектов-служб. Для получения дополнительной информации см. Connect-AipService.

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

(Get-Module AIPService -ListAvailable).CompatiblePSEditions

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

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

Модуль AIPService содержит псевдонимы для имен командлетов в модуле AADRM, поэтому все существующие сценарии будут продолжать работать. Модуль AADRM перестал поддерживаться 15 июля 2020 года.

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

Uninstall-Module -Name AADRM

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

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

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

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

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

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

Install-Module -Name AIPService

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

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

Update-Module -Name AIPService

Примечание.

Чтобы использовать модуль в PowerShell 7, запустите Install-Module -Name AIPService его из сеанса PowerShell 7. Windows PowerShell и PowerShell 7 используют отдельные папки модуля для каждого пользователя, поэтому модуль, установленный для текущего пользователя в Windows PowerShell, недоступен в PowerShell 7.

Дальнейшие действия

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

(Get-Module AIPService -ListAvailable).Version

Примечание.

В (Get-Module AIPService -ListAvailable).Version случае неудачи сначала запустите Import-Module AIPService.

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

Get-Command -Module AIPService

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

Get-Help Connect-AipService -online

Подробнее:

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

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

Примечание.

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

  • Последнее обновление: