Azure Active Directory PowerShell для Graph

  • Статья

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

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

Модуль предварительной версии Azure AD PowerShell для Graph можно скачать из коллекция PowerShell на странице AzureADPreview.

Модуль общей доступности Azure AD PowerShell для Graph можно скачать из коллекция PowerShell на странице AzureAD.

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

Модуль Azure AD PowerShell для Graph поддерживается в следующих операционных системах Windows с версией microsoft платформа .NET Framework и Windows PowerShell по умолчанию: Windows 8.1, Windows 8, Windows 7, Windows Server 2012 R2, Windows Server 2012 или Windows Server 2008 R2.

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

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

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

PS C:\WINDOWS\system32> Get-Module AzureADPreview

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

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

PS C:\WINDOWS\system32> Install-Module AzureADPreview

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

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

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

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

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

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

Connect-AzureAD -AzureEnvironment "AzureGermanyCloud"

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

У вас есть предложения?

Если у вас есть предложения по улучшению Azure Active Directory PowerShell, сообщите нам об этом.

Дополнительные сведения о Windows PowerShell

Windows PowerShell — это язык сценариев и оболочки командной строки на основе задач, разработанный для администрирования системы. В отличие от большинства оболочек, которые принимают и возвращают текст, Windows PowerShell построена на основе .NET Framework и принимает и возвращает объекты .NET Framework.

В Windows PowerShell введено понятие командлета — встроенной в оболочку простой программы командной строки, выполняющей одну функцию. Командлеты имеют следующее соглашение об именовании: глагол и существительное, разделенные дефисом (-), например Get-Help, Get-Process и Start-Service. Windows PowerShell содержит более ста основных командлетов.

Чтобы получить дополнительные сведения о командлетах, их синтаксисе, используйте команду Get-Help <cmdlet name>, где <cmdlet name> — имя командлета, о котором вы хотите узнать. Для получения более подробных сведений можно выполнить следующие команды:

  • Get-Help <cmdlet name> -Detailed
  • Get-Help <cmdlet name> -Examples
  • Get-Help <cmdlet name> -Full

Дополнительные сведения о Windows PowerShell см. в статье Начало работы с Windows PowerShell.