Установка Azure Active Directory PowerShell для Graph

  • Статья

Важно!

Azure AD PowerShell планируется устареть 30 марта 2024 г. Дополнительные сведения о планах устаревания см. в обновлении для прекращения поддержки. Мы рекомендуем продолжить миграцию на Microsoft Graph PowerShell, который является рекомендуемой модулем для взаимодействия с Azure AD. Кроме того, Microsoft Graph PowerShell позволяет получить доступ ко всем API Microsoft Graph и доступен в PowerShell 7. Ответы на часто задаваемые вопросы о миграции см. в разделе Вопросы и ответы по миграции.

Версию модуля Azure Active Directory PowerShell для Graph можно использовать для Azure AD административных задач, таких как управление пользователями, управление доменами и настройка единого входа. Приведенные здесь командлеты отличаются от командлетов MSOnline, которые являются частью Azure Active Directory PowerShell версии 1.0.

Модуль Azure AD PowerShell для Graph имеет две версии: общедоступную предварительную версию и общедоступную версию. Использование предварительной версии в рабочей среде не рекомендуется.

Скачайте модули из коллекция PowerShell используйте следующее:

Журнал версий выпусков Azure Active Directory PowerShell для Graph

Журнал выпусков модуля Azure AD и модуля предварительной версии Azure AD приведен здесь: Azure Active Directory PowerShell для Graph: журнал выпусков версий.

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

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

Модуль Azure AD поддерживается в следующих операционных системах Windows с версией microsoft платформа .NET Framework и Windows PowerShell по умолчанию:

  • Windows 8.1
  • Windows 8
  • Windows 7
  • Windows Server 2012 R2,
  • Windows Server 2012
  • Windows Server 2008 R2.

Примечание

Модуль PowerShell Azure AD несовместим с PowerShell 7. Он поддерживается только в PowerShell 5.1.

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

Install-Module AzureAD

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

Install-module AzureADPreview

Вы не можете одновременно установить предварительную и общедоступную версию на одном компьютере.

Модуль Azure AD распространяется с помощью коллекция PowerShell. Для установки элементов из коллекции требуется последняя версия модуля PowerShellGet, доступная в Windows 10, в Windows Management Framework (WMF) 5.0 или в установщике на основе MSI (для PowerShell 3 и 4).

Последняя версия модуля PowerShellGet позволяет:

  • Выполнять поиск по элементам в коллекции командлетами Find-Module и Find-Script.
  • Сохранять элементы в систему из коллекции командлетами Save-Module и Save-Script.
  • Устанавливать элементы из коллекции командлетами Install-Module и Install-Script.
  • Отправлять элементы в коллекцию командлетами Publish-Module и Publish-Script.
  • Добавлять собственный репозиторий командлетом Register-PSRepository.

Дополнительные сведения об использовании команд PowerShellGet при работе с коллекцией см. в статье Начало работы. Вы также можете запустить командлет Update-Help -Module PowerShellGet, чтобы установить локальную справку по этим командам.

Поддерживаемые операционные системы

Для модуля PowerShellGet требуется PowerShell 3.0 или более поздней версии.

Таким образом, для PowerShellGet требуется одна из следующих операционных систем:

  • Windows 10
  • Windows 8.1 Профессиональная
  • Windows 8.1 Корпоративная
  • Windows 7 SP1
  • Windows Server 2016 TP5
  • Windows Server 2012 R2
  • Windows Server 2008 R2 с пакетом обновления 1 (SP1)

Для PowerShellGet также требуется .NET Framework 4.5 или более поздней версии. Установить .NET Framework 4.5 или более поздней версии можно отсюда.

Обновление модуля Azure AD

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

Get-Module AzureADPreview

ModuleType Version Name                ExportedCommands
---------- ------- ----                ----------------
Binary     2.0.0.7 azureadpreview     {Add-AzureADAdmini...

Чтобы обновить версию Azure AD модуля PowerShell на компьютере, повторно выполните командлет Install-Module:

Install-Module AzureADPreview

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

Подключение к Azure AD

Подключитесь к веб-службе, а затем выполните любой из командлетов, рассмотренных в этой статье. Для этого выполните командлет Connect-AzureAD в командной строке Windows PowerShell. Затем вам будет предложено ввести учетные данные. Если вы хотите, вы можете предоставить свои учетные данные заранее, например следующим образом:

$AzureAdCred = Get-Credential
Connect-AzureAD -Credential $AzureAdCred

Первая команда запрашивает учетные данные и сохраняет их как $AzureAdCred. Следующая команда использует эти учетные данные в виде $azureadcred для подключения к службе.

Примечание

Модули предварительной версии Azure AD и Azure AD состоят из командлетов с различными соглашениями об именовании, например -AzureAD и -AzureADMS. Командлеты -AzureAD подключаются к конечной точке https://graph.windows.net Azure AD Graph, -AzureADMS а командлеты вызывают конечную точку graph.microsoft.comMicrosoft Graph . Проверка подлинности выполняется автоматически при изменении вызовов из одной конечной точки в другую, и вам больше не будет предложено ввести учетные данные.

Чтобы подключиться к определенной среде Azure Active Directory, используйте параметр AzureEnvironment, как показано ниже.

Connect-AzureAD -AzureEnvironment "AzureGermanyCloud"

В этом примере вы подключаете свой сеанс PowerShell к среде Azure AD для Германии. Дополнительные сведения см. в разделе о командлете Connect-AzureAD.

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