Connect-AzureRmAccount
Azure Resource Manager cmdlet istekleriyle kullanılmak üzere kimliği doğrulanmış bir hesapla Azure'a Bağlan.
Uyarı
AzureRM PowerShell modülü 29 Şubat 2024 itibarıyla resmi olarak kullanım dışı bırakılmıştır. Kullanıcıların destek ve güncelleştirmelerin devam etmesini sağlamak için AzureRM'den Az PowerShell modülüne geçmeleri tavsiye edilir.
AzureRM modülü çalışmaya devam edebilir, ancak artık bakım yapılmaz veya desteklenmez ve kullanıcının takdirine ve riskine bağlı olarak sürekli kullanım sağlanır. Az modülüne geçiş konusunda yönergeler için lütfen geçiş kaynaklarımıza bakın.
Sözdizimi
Connect-AzureRmAccount
[-Environment <String>]
[[-Credential] <PSCredential>]
[-TenantId <String>]
[-Subscription <String>]
[-ContextName <String>]
[-SkipContextPopulation]
[-Force]
[-Scope <ContextModificationScope>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Connect-AzureRmAccount
[-Environment <String>]
[-Credential] <PSCredential>
[-ServicePrincipal]
-TenantId <String>
[-Subscription <String>]
[-ContextName <String>]
[-SkipContextPopulation]
[-Force]
[-Scope <ContextModificationScope>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Connect-AzureRmAccount
[-Environment <String>]
-CertificateThumbprint <String>
-ApplicationId <String>
[-ServicePrincipal]
-TenantId <String>
[-Subscription <String>]
[-ContextName <String>]
[-SkipContextPopulation]
[-Force]
[-Scope <ContextModificationScope>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Connect-AzureRmAccount
[-Environment <String>]
[-TenantId <String>]
-AccessToken <String>
[-GraphAccessToken <String>]
[-KeyVaultAccessToken <String>]
-AccountId <String>
[-Subscription <String>]
[-ContextName <String>]
[-SkipValidation]
[-SkipContextPopulation]
[-Force]
[-Scope <ContextModificationScope>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Connect-AzureRmAccount
[-Environment <String>]
[-TenantId <String>]
[-AccountId <String>]
[-Identity]
[-ManagedServicePort <Int32>]
[-ManagedServiceHostName <String>]
[-ManagedServiceSecret <SecureString>]
[-Subscription <String>]
[-ContextName <String>]
[-SkipContextPopulation]
[-Force]
[-Scope <ContextModificationScope>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Bağlan-AzureRmAccount cmdlet'i, Azure Resource Manager cmdlet istekleriyle kullanılmak üzere kimliği doğrulanmış bir hesapla Azure'a bağlanır. Bu kimliği doğrulanmış hesabı yalnızca Azure Resource Manager cmdlet'leriyle kullanabilirsiniz. Hizmet Yönetimi cmdlet'leriyle kullanmak üzere kimliği doğrulanmış bir hesap eklemek için Add-AzureAccount veya Import-AzurePublish Ayarlar File cmdlet'ini kullanın. Geçerli kullanıcı için bağlam bulunamazsa, bu komut kullanıcının bağlam listesini her (ilk 25) aboneliği için bir bağlamla doldurur. Kullanıcı için oluşturulan bağlamların listesi "Get-AzureRmContext -ListAvailable" çalıştırılarak bulunabilir. Bu bağlam popülasyonunu atlamak için bu komutu "-SkipContextPopulation" anahtar parametresiyle çalıştırabilirsiniz. Bu cmdlet'i yürüttkten sonra Disconnect-AzureRmAccount kullanarak bir Azure hesabıyla bağlantınızı kesebilirsiniz.
Örnekler
Örnek 1: Azure hesabına bağlanmak için etkileşimli oturum açma bilgileri kullanma
PS C:\> Connect-AzureRmAccount
Account SubscriptionName TenantId Environment
------- ---------------- -------- -----------
azureuser@contoso.com Subscription1 xxxx-xxxx-xxxx-xxxx AzureCloud
Bu komut bir Azure hesabına bağlanır. Azure Resource Manager cmdlet'lerini bu hesapla çalıştırmak için, isteminde Microsoft hesabı veya kuruluş kimliği kimlik bilgilerini 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.
Örnek 2: Kuruluş kimliği kimlik bilgilerini kullanarak Azure hesabına Bağlan
PS C:\> $Credential = Get-Credential
PS C:\> Connect-AzureRmAccount -Credential $Credential
Account SubscriptionName TenantId Environment
------- ---------------- -------- -----------
azureuser@contoso.com Subscription1 xxxx-xxxx-xxxx-xxxx AzureCloud
İlk komut kullanıcı kimlik bilgilerini (kullanıcı adı ve parola) ister ve bunları $Credential değişkeninde depolar. İkinci komut, $Credential depolanan kimlik bilgilerini kullanarak bir Azure hesabına bağlanır. Bu hesap, kuruluş kimliği kimlik bilgilerini kullanarak Azure Resource Manager ile kimlik doğrulaması yapar. Bu hesapla Azure Resource Manager cmdlet'lerini çalıştırmak için çok faktörlü kimlik doğrulaması veya Microsoft hesabı kimlik bilgilerini kullanamazsınız.
Örnek 3: Azure hizmet sorumlusu hesabına Bağlan
PS C:\> $Credential = Get-Credential
PS C:\> Connect-AzureRmAccount -Credential $Credential -Tenant "xxxx-xxxx-xxxx-xxxx" -ServicePrincipal
Account SubscriptionName TenantId Environment
------- ---------------- -------- -----------
xxxx-xxxx-xxxx-xxxx Subscription1 xxxx-xxxx-xxxx-xxxx AzureCloud
İlk komut hizmet sorumlusu kimlik bilgilerini (uygulama kimliği ve hizmet sorumlusu gizli dizisi) alır ve bunları $Credential değişkeninde depolar. İkinci komut, belirtilen Kiracı için $Credential depolanan hizmet sorumlusu kimlik bilgilerini kullanarak Azure'a bağlanır. ServicePrincipal anahtar parametresi, hesabın hizmet sorumlusu olarak kimlik doğrulamasını gösterir.
Örnek 4: Belirli bir kiracı ve aboneliğin hesabına bağlanmak için etkileşimli oturum açma bilgileri kullanma
PS C:\> Connect-AzureRmAccount -Tenant "xxxx-xxxx-xxxx-xxxx" -SubscriptionId "yyyy-yyyy-yyyy-yyyy"
Account SubscriptionName TenantId Environment
------- ---------------- -------- -----------
azureuser@contoso.com Subscription1 xxxx-xxxx-xxxx-xxxx AzureCloud
Bu komut bir Azure hesabına bağlanır ve AzureRM PowerShell'i varsayılan olarak belirtilen kiracı ve abonelik için cmdlet'leri çalıştıracak şekilde yapılandırdı.
Örnek 5: Yönetilen Hizmet Kimliği Oturum Açma Bilgilerini Kullanarak Hesap Ekleme
PS C:\> Connect-AzureRmAccount -MSI
Account SubscriptionName TenantId Environment
------- ---------------- -------- -----------
MSI@50342 Subscription1 xxxx-xxxx-xxxx-xxxx AzureCloud
Bu komut, konak ortamının yönetilen hizmet kimliğini kullanarak bağlanır (örneğin, atanmış bir Yönetilen Hizmet Kimliğine sahip bir VirtualMachine üzerinde yürütülürse, bu, kodun atanan kimliği kullanarak oturum açmasına izin verir)
Örnek 6: Sertifikaları kullanarak hesap ekleme
# For more information on creating a self-signed certificate
# and giving it proper permissions, please see the following:
# https://docs.microsoft.com/en-us/azure/active-directory/develop/howto-authenticate-service-principal-powershell
PS C:\> $Thumbprint = "0SZTNJ34TCCMUJ5MJZGR8XQD3S0RVHJBA33Z8ZXV"
PS C:\> $TenantId = "00001111-aaaa-2222-bbbb-3333cccc4444"
PS C:\> $ApplicationId = "00001111-aaaa-2222-bbbb-3333cccc4444"
PS C:\> Connect-AzureRmAccount -CertificateThumbprint $Thumbprint -ApplicationId $ApplicationId -Tenant $TenantId -ServicePrincipal
Account SubscriptionName TenantId Environment
------- ---------------- -------- -----------
xxxx-xxxx-xxxx-xxxx Subscription1 xxxx-xxxx-xxxx-xxxx AzureCloud
Account : 00001111-aaaa-2222-bbbb-3333cccc4444
SubscriptionName : MyTestSubscription
SubscriptionId : 85f0f653-1f86-4d2c-a9f1-042efc00085c
TenantId : 00001111-aaaa-2222-bbbb-3333cccc4444
Environment : AzureCloud
Bu komut, sertifika tabanlı hizmet sorumlusu kimlik doğrulamasını kullanarak bir Azure hesabına bağlanır. Kimlik doğrulaması için kullanılan hizmet sorumlusu verilen sertifikayla oluşturulmuş olmalıdır.
Parametreler
-AccessToken
Bir erişim belirteci belirtir.
Tür: | String |
Position: | Named |
Default value: | None |
Gerekli: | True |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-AccountId
Erişim belirteci için hesap kimliği
Tür: | String |
Position: | Named |
Default value: | None |
Gerekli: | True |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-ApplicationId
SPN
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ı (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çmadan varsayılan bağlamın adı. Oturum açmadan sonra bu bağlamı bu ada göre seçebilirsiniz.
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 Get-Help Get-Credential yazın. 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: | 0 |
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: | AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-Environment
Oturum açmak için hesabı 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 |
-Force
Varsa, 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
Geçerli ortamda yönetilen hizmet kimliğini 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 |
-ManagedServiceHostName
Yönetilen hizmet oturum açma için ana bilgisayar adı
Tür: | String |
Position: | Named |
Default value: | localhost |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-ManagedServicePort
Yönetilen hizmet oturum açma için bağlantı noktası numarası
Tür: | Int32 |
Position: | Named |
Default value: | 50342 |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-ManagedServiceSecret
Gizli dizi, bazı tür yönetilen hizmet oturum açma bilgileri için kullanılır.
Tür: | SecureString |
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 |
-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ı atlama
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 |
-TenantId
İsteğe bağlı etki alanı adı veya kiracı kimliği. Etki alanı adı tüm oturum açma durumlarında çalışmaz. Bulut Çözümü Sağlayıcısı (CSP) oturum açma için kiracı kimliği gereklidir.
Tür: | String |
Diğer adlar: | Domain |
Position: | Named |
Default value: | None |
Gerekli: | True |
İş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
Parametreler: Abonelik (ByValue)