Как использовать Connect AzureAD в PowerShell

Модуль PowerShell Azure AD позволяет управлять вашей Azure Active Directory с помощью PowerShell. Первый шаг для использования этого модуля - использовать команду Connect-AzureAD. После того как вы подключитесь, вы сможете получать, обновлять, создавать или удалять объекты в вашей среде Azure AD.

Хорошо знать заранее, что модуль AzureAD планируется к устареванию 30 марта 2024 года. Его заменит новый модуль Microsoft Graph. В настоящее время модули MgGraph еще не полностью задокументированы, поэтому модуль Azure AD все еще часто используется.

В этой статье мы рассмотрим, как подключиться к AzureAD из PowerShell.

Требования

Перед тем как мы рассмотрим, как подключиться к Azure AD, нам сначала нужно убедиться, что у вас установлен правильный модуль в PowerShell. Чтобы проверить, установлен ли модуль, мы можем использовать командлет Get-Module.

Это вернет все модули, которые соответствуют данному имени. Если модуль не установлен, то будет возвращено $null. Чтобы установить его, мы можем использовать командлет Install-Module:

if ($null -eq (Get-Module -ListAvailable -Name AzureAD)) {
    Write-Host "Installing Azure AD module" -ForegroundColor Cyan
    Install-Module AzureAD -Repository PSGallery -AllowClobber -Force
}

Подключить AzureAD

Подключение к AzureAD довольно просто. Вам только нужно выполнить команду Connect-AzureAD, которая затем попросит вас войти с вашей учетной записью Microsoft 365. Она автоматически использует интерактивный метод, так что вы сможете выбрать свою учетную запись и использовать MFA для входа:

Connect-AzureAD

Чтобы проверить, подключены ли вы успешно, вы можете использовать командлет Get-AzureADTenantDetail. Это покажет детали арендатора, к которому вы подключены.

Подключение к другому арендатору

Мы также можем использовать модуль AzureAD для управления другими арендаторами, которыми мы управляем. Для этого нам нужно будет использовать параметр -tenantid. Здесь вы можете ввести либо идентификатор арендатора, либо доменное имя арендатора:

Connect-AzureAD -Tenant lazydev.onmicrosoft.com

Использование Connect-AzureAD в RunBook

Вы также можете использовать модуль AzureAD в Azure Runbook. Следует отметить, что модуль больше не поддерживается, поэтому Управляемые Идентификаторы, например, не будут работать напрямую. Чтобы подключить azuread в runbook, сначала нужно использовать модуль Az.

Модуль AzureAZ позволяет управлять вашей средой Azure. Мы можем использовать этот модуль для генерации токена доступа, который затем можем использовать для подключения к Azure AD.

Заметка

Если вы никогда ранее не использовали управляемые идентификаторы, обязательно прочитайте эту статью о том, как их настроить и использовать.

Сначала подключитесь к Azure с помощью управляемой идентичности в вашем RunBook:

Connect to Azure
$az = Connect-AzAccount -Identity
$az = Set-AzContext -SubscriptionName $az.context.Subscription -DefaultProfile $az.context

С установлением соединения мы можем сгенерировать необходимые токены и подключиться к AzureAD:

Generate the token
$graphToken = Get-AzAccessToken -ResourceUrl "https://graph.microsoft.com/"
$aadToken = Get-AzAccessToken -ResourceUrl "https://graph.windows.net"

Connect-AzureAD -AccountId $az.account.id -TenantId $az.tenant.id -AadAccessToken $aadToken.token -MsAccessToken $graphToken.token

Завершение

Имейте в виду, что модуль PowerShell AzureAD планируется к устареванию в марте 2024 года. Я рекомендую вам сначала попробовать создать свой скрипт с помощью нового модуля Microsoft Graph.

Надеюсь, эта статья помогла вам с cmdlet connect-azuread. Если у вас есть вопросы, просто оставьте комментарий ниже.