Connect-AzAccount

Az PowerShell modüllerinden cmdlet'lerle kullanmak üzere kimliği doğrulanmış bir hesapla Azure'a bağlanın.

Sözdizimi

Connect-AzAccount
       [-Environment <String>]
       [-Tenant <String>]
       [-AccountId <String>]
       [-Subscription <String>]
       [-AuthScope <String>]
       [-ContextName <String>]
       [-SkipContextPopulation]
       [-MaxContextPopulation <Int32>]
       [-UseDeviceAuthentication]
       [-Force]
       [-Scope <ContextModificationScope>]
       [-DefaultProfile <IAzureContextContainer>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Connect-AzAccount
       [-Environment <String>]
       -Credential <PSCredential>
       [-ServicePrincipal]
       -Tenant <String>
       [-Subscription <String>]
       [-AuthScope <String>]
       [-ContextName <String>]
       [-SkipContextPopulation]
       [-MaxContextPopulation <Int32>]
       [-Force]
       [-Scope <ContextModificationScope>]
       [-DefaultProfile <IAzureContextContainer>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Connect-AzAccount
       [-Environment <String>]
       -Credential <PSCredential>
       [-Tenant <String>]
       [-Subscription <String>]
       [-AuthScope <String>]
       [-ContextName <String>]
       [-SkipContextPopulation]
       [-MaxContextPopulation <Int32>]
       [-Force]
       [-Scope <ContextModificationScope>]
       [-DefaultProfile <IAzureContextContainer>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Connect-AzAccount
       [-Environment <String>]
       -CertificateThumbprint <String>
       -ApplicationId <String>
       [-ServicePrincipal]
       -Tenant <String>
       [-Subscription <String>]
       [-AuthScope <String>]
       [-ContextName <String>]
       [-SkipContextPopulation]
       [-MaxContextPopulation <Int32>]
       [-Force]
       [-SendCertificateChain]
       [-Scope <ContextModificationScope>]
       [-DefaultProfile <IAzureContextContainer>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Connect-AzAccount
       [-Environment <String>]
       -ApplicationId <String>
       [-ServicePrincipal]
       -Tenant <String>
       [-Subscription <String>]
       [-ContextName <String>]
       [-SkipContextPopulation]
       [-MaxContextPopulation <Int32>]
       [-Force]
       -FederatedToken <String>
       [-Scope <ContextModificationScope>]
       [-DefaultProfile <IAzureContextContainer>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Connect-AzAccount
       [-Environment <String>]
       -ApplicationId <String>
       [-ServicePrincipal]
       -Tenant <String>
       [-Subscription <String>]
       [-ContextName <String>]
       [-SkipContextPopulation]
       [-MaxContextPopulation <Int32>]
       [-Force]
       [-SendCertificateChain]
       -CertificatePath <String>
       [-CertificatePassword <SecureString>]
       [-Scope <ContextModificationScope>]
       [-DefaultProfile <IAzureContextContainer>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Connect-AzAccount
       [-Environment <String>]
       [-Tenant <String>]
       -AccessToken <String>
       [-GraphAccessToken <String>]
       [-MicrosoftGraphAccessToken <String>]
       [-KeyVaultAccessToken <String>]
       -AccountId <String>
       [-Subscription <String>]
       [-ContextName <String>]
       [-SkipValidation]
       [-SkipContextPopulation]
       [-MaxContextPopulation <Int32>]
       [-Force]
       [-Scope <ContextModificationScope>]
       [-DefaultProfile <IAzureContextContainer>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Connect-AzAccount
       [-Environment <String>]
       [-Tenant <String>]
       [-AccountId <String>]
       [-Identity]
       [-Subscription <String>]
       [-AuthScope <String>]
       [-ContextName <String>]
       [-SkipContextPopulation]
       [-MaxContextPopulation <Int32>]
       [-Force]
       [-Scope <ContextModificationScope>]
       [-DefaultProfile <IAzureContextContainer>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Description

Cmdlet, Connect-AzAccount Az PowerShell modüllerinden cmdlet'lerle kullanmak üzere kimliği doğrulanmış bir hesapla Azure'a bağlanır. Bu kimliği doğrulanmış hesabı yalnızca Azure Resource Manager istekleriyle kullanabilirsiniz. Hizmet Yönetimi ile kullanmak üzere kimliği doğrulanmış bir hesap eklemek için Azure PowerShell modülündeki cmdlet'ini kullanın Add-AzureAccount . Geçerli kullanıcı için bağlam bulunamazsa, kullanıcının bağlam listesi ilk 25 aboneliğinin her biri için bir bağlamla doldurulur. Kullanıcı için oluşturulan bağlamların listesi çalıştırılarak Get-AzContext -ListAvailablebulunabilir. Bu bağlam popülasyonunu atlamak için SkipContextPopulation anahtar parametresini belirtin. Bu cmdlet'i yürüttkten sonra kullanarak Disconnect-AzAccountazure hesabı bağlantısını kesebilirsiniz.

Örnekler

Örnek 1: Azure hesabına bağlanma

Bu örnek bir Azure hesabına bağlanır. Bir Microsoft hesabı veya kuruluş kimliği kimlik bilgileri sağlamanız gerekir. Kimlik bilgileriniz için çok faktörlü kimlik doğrulaması etkinleştirildiyse, etkileşimli seçeneği kullanarak oturum açmanız veya hizmet sorumlusu kimlik doğrulamasını kullanmanız gerekir.

Connect-AzAccount

Please select the account you want to login with.

Retrieving subscriptions for the selection...
[Tenant and subscription selection]

No      Subscription name                       Subscription ID                             Tenant domain name        
----    ------------------------------------    ----------------------------------------    --------------------------
[1]     Subscription1                           xxxx-xxxx-xxxx-xxxx                         xxxxxxxxx.xxxxxxxxxxx.com
[2]     Subscription2                           xxxx-xxxx-xxxx-xxxx                         xxxxxxxxx.xxxxxxxxxxx.com
...
[9]     Subscription9                           xxxx-xxxx-xxxx-xxxx                         xxxxxxxxx.xxxxxxxxxxx.com

Select a tenant and subscription: 1 <requires user's input here>

Subscription name                       Tenant domain name
------------------------------------    --------------------------
Subscription1                           xxxxxxxxx.xxxxxxxxxxx.com

[Announcements]
Share your feedback regarding your experience with `Connect-AzAccount` at: https://aka.ms/azloginfeedback

If you encounter any problem, please open an issue at: https://aka.ms/azpsissue

SubscriptionName     Tenant
-----------------    ------
Subscription1        xxxxxxxxx.xxxxxxxxxxx.com

Örnek 2: Kuruluş kimliği kimlik bilgilerini kullanarak Azure'a bağlanma

Bu senaryo yalnızca kullanıcının çok faktörlü kimlik doğrulaması açık olmadığında çalışır. İlk komut, kullanıcı kimlik bilgilerini ister ve bunları değişkende $Credential depolar. İkinci komut, içinde $Credentialdepolanan kimlik bilgilerini kullanarak bir Azure hesabına bağlanır. Bu hesap, kuruluş kimliği kimlik bilgilerini kullanarak Azure'da kimlik doğrulaması yapar.

$Credential = Get-Credential
Connect-AzAccount -Credential $Credential

Account                SubscriptionName TenantId                Environment
-------                ---------------- --------                -----------
azureuser@contoso.com  Subscription1    xxxx-xxxx-xxxx-xxxx     AzureCloud

Örnek 3: Hizmet sorumlusu hesabı kullanarak Azure'a bağlanma

Bu komut, hizmet sorumlusu kimlik bilgilerini değişkeninde $Credential depolar. Ardından, değişkende depolanan hizmet sorumlusu kimlik bilgilerini kullanarak belirtilen Azure kiracısına $Credential bağlanır. ServicePrincipal anahtar parametresi, hesabın hizmet sorumlusu olarak kimlik doğrulamasını gösterir.

$SecurePassword = Read-Host -Prompt 'Enter a Password' -AsSecureString
$TenantId = 'yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyy'
$ApplicationId = 'zzzzzzzz-zzzz-zzzz-zzzz-zzzzzzzz'
$Credential = New-Object -TypeName System.Management.Automation.PSCredential -ArgumentList $ApplicationId, $SecurePassword
Connect-AzAccount -ServicePrincipal -TenantId $TenantId -Credential $Credential

Account                SubscriptionName TenantId                Environment
-------                ---------------- --------                -----------
xxxx-xxxx-xxxx-xxxx    Subscription1    xxxx-xxxx-xxxx-xxxx     AzureCloud

Örnek 4: Belirli bir kiracıya ve aboneliğe bağlanmak için etkileşimli oturum açma bilgileri kullanma

Bu örnek, belirtilen kiracı ve aboneliğe sahip bir Azure hesabına bağlanır.

Connect-AzAccount -Tenant 'xxxx-xxxx-xxxx-xxxx' -SubscriptionId 'yyyy-yyyy-yyyy-yyyy'

Account                SubscriptionName TenantId                Environment
-------                ---------------- --------                -----------
azureuser@contoso.com  Subscription1    xxxx-xxxx-xxxx-xxxx     AzureCloud

Örnek 5: Yönetilen Hizmet Kimliği kullanarak bağlanma

Bu örnek, konak ortamının sistem tarafından atanan Yönetilen Hizmet Kimliği (MSI) kullanılarak bağlanır. Örneğin, MSI atanmış bir sanal makineden Azure'da oturum açarsınız.

Connect-AzAccount -Identity
Set-AzContext -Subscription Subscription1

Account                SubscriptionName TenantId                Environment
-------                ---------------- --------                -----------
MSI@50342              Subscription1    xxxx-xxxx-xxxx-xxxx     AzureCloud

Örnek 6: Yönetilen Hizmet Kimliği oturum açma bilgilerini ve ClientId'yi kullanarak bağlanma

Bu örnek, myUserAssignedIdentity yönetilen hizmet kimliğini kullanarak bağlanır. Kullanıcı tarafından atanan kimliği sanal makineye ekler, ardından kullanıcı tarafından atanan kimliğin ClientId değerini kullanarak bağlanır. Daha fazla bilgi için bkz . Azure VM'sinde Azure kaynakları için yönetilen kimlikleri yapılandırma.

$identity = Get-AzUserAssignedIdentity -ResourceGroupName 'myResourceGroup' -Name 'myUserAssignedIdentity'
Get-AzVM -ResourceGroupName contoso -Name testvm | Update-AzVM -IdentityType UserAssigned -IdentityId $identity.Id
Connect-AzAccount -Identity -AccountId $identity.ClientId # Run on the virtual machine

Account                SubscriptionName TenantId                Environment
-------                ---------------- --------                -----------
yyyy-yyyy-yyyy-yyyy    Subscription1    xxxx-xxxx-xxxx-xxxx     AzureCloud

Örnek 7: Sertifikaları kullanarak bağlanma

Bu örnek, sertifika tabanlı hizmet sorumlusu kimlik doğrulaması kullanarak bir Azure hesabına bağlanır. Kimlik doğrulaması için kullanılan hizmet sorumlusu belirtilen sertifikayla oluşturulmalıdır. Otomatik olarak imzalanan sertifikalar oluşturma ve bu sertifikalara izin atama hakkında daha fazla bilgi için bkz . Azure PowerShell kullanarak sertifikayla hizmet sorumlusu oluşturma

$Thumbprint = 'XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX'
$TenantId = 'yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyy'
$ApplicationId = '00000000-0000-0000-0000-00000000'
Connect-AzAccount -CertificateThumbprint $Thumbprint -ApplicationId $ApplicationId -Tenant $TenantId -ServicePrincipal

Account                      SubscriptionName TenantId                        Environment
-------                      ---------------- --------                        -----------
xxxxxxxx-xxxx-xxxx-xxxxxxxxx Subscription1    yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyy AzureCloud

Account          : xxxxxxxx-xxxx-xxxx-xxxxxxxx
SubscriptionName : MyTestSubscription
SubscriptionId   : zzzzzzzz-zzzz-zzzz-zzzz-zzzzzzzz
TenantId         : yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyy
Environment      : AzureCloud

Örnek 8: AuthScope ile bağlanma

AuthScope, veri düzlemi kaynaklarının ARM kaynaklarından daha iyi kimlik doğrulamasına sahip olduğu senaryolarını desteklemek için kullanılır; örneğin depolama MFA gerektirir, ancak ARM bunu yapmaz. AuthScope belirtildikten sonra, örneğin Depolama, Connect-AzAccount önce depolama kapsamıyla https://storage.azure.com/oturum açar, ardından ARM için sessizce belirteç gerektirir.

Connect-AzAccount -AuthScope Storage

Account                SubscriptionName TenantId                Environment
-------                ---------------- --------                -----------
yyyy-yyyy-yyyy-yyyy    Subscription1    xxxx-xxxx-xxxx-xxxx     AzureCloud

Örnek 9: Sertifika dosyasını kullanarak bağlanma

Bu örnek, sertifika tabanlı hizmet sorumlusu kimlik doğrulaması kullanarak bir Azure hesabına bağlanır. tarafından CertficatePathbelirtilen sertifika dosyasında hem sertifika hem de giriş olarak özel anahtar bulunmalıdır.

$SecurePassword = ConvertTo-SecureString -String "****" -AsPlainText -Force
$TenantId = 'yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyy'
$ApplicationId = 'zzzzzzzz-zzzz-zzzz-zzzz-zzzzzzzz'
Connect-AzAccount -ServicePrincipal -ApplicationId $ApplicationId -TenantId $TenantId -CertificatePath './certificatefortest.pfx' -CertificatePassword $securePassword

Account                     SubscriptionName TenantId                        Environment
-------                     ---------------- --------                        -----------
xxxxxxxx-xxxx-xxxx-xxxxxxxx Subscription1    yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyy AzureCloud

Örnek 10: WAM kullanarak etkileşimli olarak bağlanma

Bu örnekte WAM (Web Hesabı Yöneticisi) yapılandırmasının nasıl etkinleştirileceği ve Azure'a bağlanmak için nasıl kullanılacağı gösterilmektedir.

Update-AzConfig -EnableLoginByWam $true
Connect-AzAccount

Account                     SubscriptionName TenantId                        Environment
-------                     ---------------- --------                        -----------
xxxxxxxx-xxxx-xxxx-xxxxxxxx Subscription1    yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyy AzureCloud

Parametreler

-AccessToken

Bir erişim belirteci belirtir.

Dikkat

Erişim belirteçleri bir kimlik bilgisi türüdür. Bunları gizli tutmak için uygun güvenlik önlemlerini almanız gerekir. Erişim belirteçleri de zaman aşımına uyabilir ve uzun süre çalışan görevlerin tamamlanmasını engelleyebilir.

Tür:String
Position:Named
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-AccountId

Varsayılan (UserWithSubscriptionId) parametre kümesinde oturum açmak için Hesap Kimliği / Kullanıcı Kimliği / Kullanıcı Adı; AccessToken parametre kümesinde erişim belirteci için hesap kimliği; ManagedService parametre kümesindeki yönetilen hizmet için hesap kimliği. Yönetilen hizmet kaynak kimliği veya ilişkili istemci kimliği olabilir. Sistem tarafından atanan kimliği kullanmak için bu alanı boş bırakın.

Tür:String
Position:Named
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-ApplicationId

Hizmet sorumlusunun uygulama kimliği.

Tür:String
Position:Named
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-AuthScope

Oturum açma için isteğe bağlı OAuth kapsamı, önceden tanımlanmış değerler desteklenir: AadGraph, AnalysisServices, Attestation, Batch, DataLake, KeyVault, OperationalInsights, Storage, Synapse. Ayrıca gibi https://storage.azure.com/kaynak kimliğini de destekler.

Tür:String
Diğer adlar:AuthScopeTypeName
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-CertificatePassword

pkcs#12 sertifika dosyasına erişmek için gereken parola.

Tür:SecureString
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-CertificatePath

certficate dosyasının pkcs#12 biçimindeki yolu.

Tür:String
Position:Named
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-CertificateThumbprint

Sertifika Karması veya Parmak İzi.

Tür:String
Position:Named
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Confirm

Cmdlet'i çalıştırmadan önce sizden onay ister.

Tür:SwitchParameter
Diğer adlar:cf
Position:Named
Default value:False
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-ContextName

Bu oturum açma için varsayılan Azure bağlamının adı. Azure bağlamları hakkında daha fazla bilgi için bkz . Azure PowerShell bağlam nesneleri.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Credential

PSCredential nesnesini belirtir. PSCredential nesnesi hakkında daha fazla bilgi için yazınGet-Help Get-Credential. PSCredential nesnesi, kuruluş kimliği kimlik bilgileri için kullanıcı kimliği ve parola ya da hizmet sorumlusu kimlik bilgileri için uygulama kimliği ve gizli dizi sağlar.

Tür:PSCredential
Position:Named
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-DefaultProfile

Azure ile iletişim için kullanılan kimlik bilgileri, hesap, kiracı ve abonelik.

Tür:IAzureContextContainer
Diğer adlar:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Environment

Azure hesabını içeren ortam.

Tür:String
Diğer adlar:EnvironmentName
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-FederatedToken

Başka bir kimlik sağlayıcısı tarafından sağlanan belirteci belirtir. Bu belirteçteki veren ve konu, önce ApplicationId tarafından güvenilecek şekilde yapılandırılmalıdır.

Dikkat

Federasyon belirteçleri bir kimlik bilgisi türüdür. Bunları gizli tutmak için uygun güvenlik önlemlerini almanız gerekir. Federasyon belirteçleri de zaman aşımına uyabilir ve uzun süre çalışan görevlerin tamamlanmasını engelleyebilir.

Tür:String
Diğer adlar:ClientAssertion
Position:Named
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Force

İstenmeden var olan bağlamın üzerine aynı adla yazın.

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-GraphAccessToken

Graph Hizmeti için AccessToken.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Identity

Yönetilen Hizmet Kimliği kullanarak oturum açın.

Tür:SwitchParameter
Diğer adlar:MSI, ManagedService
Position:Named
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-KeyVaultAccessToken

KeyVault Hizmeti için AccessToken.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-MaxContextPopulation

Oturum açmadan sonra bağlamları doldurmak için maksimum abonelik numarası. Varsayılan: 25. Bağlamlara yönelik tüm abonelikleri doldurmak için -1 olarak ayarlayın.

Tür:Int32
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-MicrosoftGraphAccessToken

Microsoft Graph'a erişim belirteci

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Scope

Bağlam değişikliklerinin kapsamını belirler; örneğin, değişikliklerin yalnızca geçerli işleme mi yoksa bu kullanıcı tarafından başlatılan tüm oturumlara mı uygulanacağını belirler.

Tür:ContextModificationScope
Kabul edilen değerler:Process, CurrentUser
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-SendCertificateChain

Azure AD'de kolay sertifika geçişi elde etmek için x5c isteğinin (sertifikanın ortak anahtarı) STS'ye gönderilip gönderilmeydiğini belirtir.

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-ServicePrincipal

Bu hesabın hizmet sorumlusu kimlik bilgileri sağlayarak kimlik doğrulamasını gösterir.

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-SkipContextPopulation

Bağlam bulunamazsa bağlam popülasyonu atlar.

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-SkipValidation

Erişim belirteci için doğrulamayı atlayın.

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Subscription

Abonelik Adı veya Kimliği.

Tür:String
Diğer adlar:SubscriptionName, SubscriptionId
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-Tenant

İsteğe bağlı kiracı adı veya kimliği.

Not

Geçerli API'nin sınırlamaları nedeniyle, bir işletmeden işletmeye (B2B) hesabıyla bağlanırken kiracı adı yerine kiracı kimliği kullanmanız gerekir.

Tür:String
Diğer adlar:Domain, TenantId
Position:Named
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-UseDeviceAuthentication

Tarayıcı denetimi yerine cihaz kodu kimlik doğrulaması kullanın.

Tür:SwitchParameter
Diğer adlar:DeviceCode, DeviceAuth, Device
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-WhatIf

Cmdlet çalıştırılıyorsa ne olacağını gösterir. Cmdlet çalıştırılmaz.

Tür:SwitchParameter
Diğer adlar:wi
Position:Named
Default value:False
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

Girişler

String

Çıkışlar

PSAzureProfile