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

Версию модуля PowerShell Azure Active Directory для 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.

Примечание

Модуль Azure AD PowerShell несовместим с 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...

Чтобы обновить версию модуля PowerShell для Azure AD на компьютере, повторно выполните командлет 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.

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