Azure Active Directory (MSOnline)

Важно!

модули PowerShell Azure AD и MSOnline устарели с 30 марта 2024 г. Дополнительные сведения см. в обновлении для устаревания. После этой даты поддержка этих модулей будет ограничена поддержкой миграции пакета SDK Microsoft Graph PowerShell и исправлений безопасности. Нерекомендуемые модули продолжат работать до 30 марта 2025 г.

Мы рекомендуем выполнить миграцию в Microsoft Graph PowerShell для взаимодействия с Microsoft Entra ID (ранее Azure AD). Распространенные вопросы о миграции см. в разделе Вопросы и ответы о миграции. Примечание: В версиях MSOnline 1.0.x могут возникнуть сбои после 30 июня 2024 г.

Командлеты MSOnline можно использовать для Azure AD административных задач, таких как управление пользователями, управление доменом и настройка единого входа. Эта статья содержит инструкции по установке этих командлетов для использования с каталогом.

Установка MSOnline

Модуль MSOnline поддерживается в следующих операционных системах 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

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

$Msolcred = Get-credential
Connect-MsolService -Credential $MsolCred

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

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

Connect-MsolService -AzureEnvironment "AzureGermanyCloud"

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

Дополнительные сведения см. в документации по командлету Connect-MsolService.

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

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

New-Item c:\MsolHelp -Type directory
Get-command | Where-Object {$_.name -like "*msol*"} | Format-List | Out-File c:\MsolHelp\msolcmdlets.txt
Notepad c:\MsolHelp\msolcmdlets.txt

• Чтобы просмотреть примеры командлета, выполните следующую команду в командной строке Windows PowerShell: Get-Help <cmdlet-name> -Examples

• Чтобы просмотреть имя, краткий обзор, описание, описания параметров и примеры командлета, выполните следующую команду в командной строке Windows PowerShell: Get-Help <cmdlet-name> -Detailed

• Чтобы просмотреть имя, краткий обзор, описание, информацию о параметрах и примеры командлета, выполните следующую команду в командной строке Windows PowerShell: Get-Help <cmdlet-name> -Full

Примечание

MsOnline PowerShell может использоваться только пользователями, которые являются членами каталога. Гостевые пользователи не могут использовать MSOnline PowerShell.

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

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

В Windows PowerShell введено понятие командлета — встроенной в оболочку простой программы командной строки, выполняющей одну функцию.

Для командлетов применяется следующее соглашение об именовании: глагол и существительное, разделенные дефисом (-), например Get-Help, Get-Process и Start-Service.

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