Connect-AzureAD
Подключается к учетной записи, прошедшей проверку подлинности, для использования запросов командлета Active Directory.
Синтаксис
Connect-AzureAD
[-AzureEnvironmentName <EnvironmentName>]
[-TenantId <String>]
[-Credential <PSCredential>]
[-AccountId <String>]
[-LogLevel <LogLevel>]
[-LogFilePath <String>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Connect-AzureAD
[-AzureEnvironmentName <EnvironmentName>]
-TenantId <String>
-CertificateThumbprint <String>
-ApplicationId <String>
[-LogLevel <LogLevel>]
[-LogFilePath <String>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Connect-AzureAD
[-AzureEnvironmentName <EnvironmentName>]
[-TenantId <String>]
-AadAccessToken <String>
[-MsAccessToken <String>]
-AccountId <String>
[-LogLevel <LogLevel>]
[-LogFilePath <String>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Описание
Командлет Connect-AzureAD подключает учетную запись с проверкой подлинности для использования в запросах командлета Azure Active Directory.
Эту учетную запись с проверкой подлинности можно использовать только с командлетами Azure Active Directory.
Примеры
Пример 1. Подключение сеанса PowerShell к клиенту
PS C:\> Connect-AzureAD -Confirm
Эта команда подключает текущий сеанс PowerShell к клиенту Azure Active Directory. Команда запрашивает имя пользователя и пароль для клиента, к которому вы хотите подключиться. Параметр Confirm запрашивает подтверждение.
Если для учетных данных включена многофакторная проверка подлинности, необходимо выполнить вход с помощью интерактивного параметра или использовать проверку подлинности субъекта-службы.
Пример 2. Подключение сеанса с помощью переменной
PS C:\> $Credential = Get-Credential
PS C:\> Connect-AzureAD -Credential $Credential
Первая команда получает учетные данные пользователя, а затем сохраняет их в переменной $Credential.
Вторая команда подключает текущий сеанс PowerShell, используя учетные данные в $Credential.
Эта учетная запись выполняет проверку подлинности в Azure Active Directory, используя учетные данные идентификатора организации. Для запуска командлетов Azure Active Directory с этой учетной записью нельзя использовать многофакторную проверку подлинности или учетные данные учетной записи Майкрософт.
Пример 3. Подключение сеанса в качестве субъекта-службы
# Login to Azure AD PowerShell With Admin Account
Connect-AzureAD
# Create the self signed cert
$currentDate = Get-Date
$endDate = $currentDate.AddYears(1)
$notAfter = $endDate.AddYears(1)
$pwd = "<password>"
$thumb = (New-SelfSignedCertificate -CertStoreLocation cert:\localmachine\my -DnsName com.foo.bar -KeyExportPolicy Exportable -Provider "Microsoft Enhanced RSA and AES Cryptographic Provider" -NotAfter $notAfter).Thumbprint
$pwd = ConvertTo-SecureString -String $pwd -Force -AsPlainText
Export-PfxCertificate -cert "cert:\localmachine\my\$thumb" -FilePath c:\temp\examplecert.pfx -Password $pwd
# Load the certificate
$cert = New-Object System.Security.Cryptography.X509Certificates.X509Certificate("C:\temp\examplecert.pfx", $pwd)
$keyValue = [System.Convert]::ToBase64String($cert.GetRawCertData())
# Create the Azure Active Directory Application
$application = New-AzureADApplication -DisplayName "test123" -IdentifierUris "https://test123"
New-AzureADApplicationKeyCredential -ObjectId $application.ObjectId -CustomKeyIdentifier "Test123" -StartDate $currentDate -EndDate $endDate -Type AsymmetricX509Cert -Usage Verify -Value $keyValue
# Create the Service Principal and connect it to the Application
$sp=New-AzureADServicePrincipal -AppId $application.AppId
# Give the Service Principal Reader access to the current tenant (Get-AzureADDirectoryRole)
Add-AzureADDirectoryRoleMember -ObjectId 5997d714-c3b5-4d5b-9973-ec2f38fd49d5 -RefObjectId $sp.ObjectId
# Get Tenant Detail
$tenant=Get-AzureADTenantDetail
# Now you can login to Azure PowerShell with your Service Principal and Certificate
Connect-AzureAD -TenantId $tenant.ObjectId -ApplicationId $sp.AppId -CertificateThumbprint $thumb
Эта команда выполняет проверку подлинности пользователя в Azure Active Directory в качестве субъекта-службы.
Параметры
-AadAccessToken
Указывает маркер доступа Azure Active Directory Graph.
Тип: | String |
Position: | Named |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-AccountId
Указывает идентификатор учетной записи. При проверке подлинности с помощью маркера доступа пользователя необходимо указать имя участника-пользователя.
Тип: | String |
Position: | Named |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-ApplicationId
Указывает идентификатор приложения субъекта-службы.
Тип: | String |
Position: | Named |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-AzureEnvironmentName
Указывает имя среды Azure. Допустимые значения для этого параметра:
- AzureCloud;
- AzureChinaCloud;
- AzureUSGovernment;
- AzureGermanyCloud.
Значение по умолчанию — AzureCloud.
Тип: | EnvironmentName |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-CertificateThumbprint
Указывает отпечаток сертификата цифрового открытого ключа X.509 учетной записи пользователя, имеющего разрешение на выполнение этого действия.
Тип: | String |
Position: | Named |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-Confirm
Запрос подтверждения перед выполнением командлета.
Тип: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-Credential
Указывает объект PSCredential. Чтобы получить дополнительные сведения об объекте PSCredential, введите Get-Help Get-Credential.
Объект PSCredential предоставляет идентификатор пользователя и пароль для учетных данных идентификатора организации.
Тип: | PSCredential |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-InformationAction
Указывает, как этот командлет реагирует на информационное событие. Допустимые значения для этого параметра:
- Продолжить
- Игнорировать
- Inquire
- SilentlyContinue
- Остановить
- Приостановить
Тип: | ActionPreference |
Aliases: | infa |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-InformationVariable
Указывает переменную, в которой будет храниться сообщение о информационном событии.
Тип: | String |
Aliases: | iv |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-LogFilePath
Путь, в который записывается файл журнала для этого сеанса PowerShell. Укажите здесь значение, если необходимо отклониться от расположения файла журнала PowerShell по умолчанию.
Тип: | String |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-LogLevel
Задает уровень журнала. Ниже приведены аккумлируемые значения для этого параметра:
- Info
- Ошибка
- Предупреждение
- Нет
Значение по умолчанию — Info.
Тип: | LogLevel |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-MsAccessToken
Указывает маркер доступа Microsoft Graph.
Тип: | String |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-TenantId
Указывает идентификатор клиента.
Если этот параметр не указан, учетная запись проходит проверку подлинности в домашнем клиенте.
Необходимо указать параметр TenantId для проверки подлинности в качестве субъекта-службы или при использовании учетной записи Майкрософт.
Тип: | String |
Aliases: | Domain, TenantDomain |
Position: | Named |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-WhatIf
Показывает, что произойдет при запуске командлета. Командлет не выполняется.
Тип: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |