Partilhar via


Connect-AzureAD

Liga-se a uma conta autenticada para utilizar pedidos de cmdlets do Active Directory.

Sintaxe

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>]

Description

O cmdlet Connect-AzureAD liga uma conta autenticada para utilizar para pedidos de cmdlets do Azure Active Directory.

Só pode utilizar esta conta autenticada com cmdlets do Azure Active Directory.

Exemplos

Exemplo 1: Ligar uma sessão do PowerShell a um inquilino

PS C:\> Connect-AzureAD -Confirm

Este comando liga a sessão atual do PowerShell a um inquilino do Azure Active Directory. O comando pede-lhe um nome de utilizador e uma palavra-passe para o inquilino ao qual pretende ligar. O parâmetro Confirmar pede-lhe confirmação.

Se a autenticação multifator estiver ativada para as suas credenciais, tem de iniciar sessão com a opção interativa ou utilizar a autenticação do principal de serviço.

Exemplo 2: Ligar uma sessão com uma variável

PS C:\> $Credential = Get-Credential
PS C:\> Connect-AzureAD -Credential $Credential

O primeiro comando obtém as credenciais de utilizador e, em seguida, armazena-as na variável $Credential.

O segundo comando liga a sessão atual do PowerShell com as credenciais no $Credential.

Esta conta é autenticada com o Azure Active Directory através de credenciais de ID organizacional. Não pode utilizar a autenticação multifator ou as credenciais da conta Microsoft para executar cmdlets do Azure Active Directory com esta conta.

Exemplo 3: Ligar uma sessão como principal de serviço

# 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

Este comando autentica o utilizador no Azure Active Directory como um principal de serviço.

Parâmetros

-AadAccessToken

Especifica um token de acesso do Azure Active Directory Graph.

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-AccountId

Especifica o ID de uma conta. Tem de especificar o UPN do utilizador ao autenticar com um token de acesso de utilizador.

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-ApplicationId

Especifica o ID da aplicação do principal de serviço.

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-AzureEnvironmentName

Especifica o nome do ambiente do Azure. Os valores aceitáveis para este parâmetro são:

  • AzureCloud
  • AzureChinaCloud
  • AzureUSGovernment
  • AzureGermanyCloud

O valor predefinido é AzureCloud.

Tipo:EnvironmentName
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-CertificateThumbprint

Especifica o thumbprint do certificado de um certificado X.509 de chave pública digital de uma conta de utilizador com permissão para efetuar esta ação.

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Confirm

Solicita a sua confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Credential

Especifica um objeto PSCredential. Para obter mais informações sobre o objeto PSCredential, escreva Get-Help Get-Credential.

O objeto PSCredential fornece o ID de utilizador e a palavra-passe para credenciais de ID organizacional.

Tipo:PSCredential
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-InformationAction

Especifica como este cmdlet responde a um evento de informações. Os valores aceitáveis para este parâmetro são:

  • Continuar
  • Ignorar
  • Inquire
  • SilentlyContinue
  • Parar
  • Suspender
Tipo:ActionPreference
Aliases:infa
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-InformationVariable

Especifica uma variável na qual armazenar uma mensagem de evento de informações.

Tipo:String
Aliases:iv
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-LogFilePath

O caminho no qual o ficheiro de registo desta sessão do PowerShell é escrito. Forneça um valor aqui se precisar de se desviar da localização predefinida do ficheiro de registo do PowerShell.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-LogLevel

Especifica o nível de registo. Os valores accdeptable para este parâmetro são:

  • Informações
  • Erro
  • Aviso
  • Nenhuma

O valor predefinido é Info.

Tipo:LogLevel
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-MsAccessToken

Especifica um token de acesso do Microsoft Graph.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-TenantId

Especifica o ID de um inquilino.

Se não especificar este parâmetro, a conta será autenticada com o inquilino raiz.

Tem de especificar o parâmetro TenantId para autenticar como principal de serviço ou ao utilizar a conta Microsoft.

Tipo:String
Aliases:Domain, TenantDomain
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-WhatIf

Apresenta o que aconteceria mediante a execução do cmdlet. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False