Connect-AzureRmAccount

Başvuru

Modül:: AzureRM.Profile

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.

Syntax

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 = "4cd76576-b611-43d0-8f2b-adcb139531bf"
PS C:\> $ApplicationId = "3794a65a-e4e4-493d-ac1d-f04308d712dd"
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          : 3794a65a-e4e4-493d-ac1d-f04308d712dd
SubscriptionName : MyTestSubscription
SubscriptionId   : 85f0f653-1f86-4d2c-a9f1-042efc00085c
TenantId         : 4cd76576-b611-43d0-8f2b-adcb139531bf
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
varsayılan değer:	None
Gerekli:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-AccountId

Erişim belirteci için hesap kimliği

Tür:	String
Position:	Named
varsayılan değer:	None
Gerekli:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-ApplicationId

SPN

Tür:	String
Position:	Named
varsayılan değer:	None
Gerekli:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-CertificateThumbprint

Sertifika Karması (Parmak İzi)

Tür:	String
Position:	Named
varsayılan değer:	None
Gerekli:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

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

Tür:	SwitchParameter
Aliases:	cf
Position:	Named
varsayılan değer:	False
Gerekli:	False
Accept pipeline input:	False
Accept wildcard characters:	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
varsayılan değer:	None
Gerekli:	False
Accept pipeline input:	False
Accept wildcard characters:	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
varsayılan değer:	None
Gerekli:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultProfile

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

Tür:	IAzureContextContainer
Aliases:	AzureRmContext, AzureCredential
Position:	Named
varsayılan değer:	None
Gerekli:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Environment

Oturum açmak için hesabı içeren ortam

Tür:	String
Aliases:	EnvironmentName
Position:	Named
varsayılan değer:	None
Gerekli:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Force

Varsa, var olan bağlamın üzerine aynı adla yazın.

Tür:	SwitchParameter
Position:	Named
varsayılan değer:	None
Gerekli:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-GraphAccessToken

Graph Hizmeti için AccessToken

Tür:	String
Position:	Named
varsayılan değer:	None
Gerekli:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Identity

Geçerli ortamda yönetilen hizmet kimliğini kullanarak oturum açın.

Tür:	SwitchParameter
Aliases:	MSI, ManagedService
Position:	Named
varsayılan değer:	None
Gerekli:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-KeyVaultAccessToken

KeyVault Hizmeti için AccessToken

Tür:	String
Position:	Named
varsayılan değer:	None
Gerekli:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ManagedServiceHostName

Yönetilen hizmet oturum açma için ana bilgisayar adı

Tür:	String
Position:	Named
varsayılan değer:	localhost
Gerekli:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ManagedServicePort

Yönetilen hizmet oturum açma için bağlantı noktası numarası

Tür:	Int32
Position:	Named
varsayılan değer:	50342
Gerekli:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ManagedServiceSecret

Gizli dizi, bazı tür yönetilen hizmet oturum açma bilgileri için kullanılır.

Tür:	SecureString
Position:	Named
varsayılan değer:	None
Gerekli:	False
Accept pipeline input:	False
Accept wildcard characters:	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
varsayılan değer:	None
Gerekli:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ServicePrincipal

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

Tür:	SwitchParameter
Position:	Named
varsayılan değer:	None
Gerekli:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-SkipContextPopulation

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

Tür:	SwitchParameter
Position:	Named
varsayılan değer:	None
Gerekli:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SkipValidation

Erişim belirteci için doğrulamayı atlama

Tür:	SwitchParameter
Position:	Named
varsayılan değer:	None
Gerekli:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Subscription

Abonelik Adı veya Kimliği

Tür:	String
Aliases:	SubscriptionName, SubscriptionId
Position:	Named
varsayılan değer:	None
Gerekli:	False
Accept pipeline input:	True
Accept wildcard characters:	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
Aliases:	Domain
Position:	Named
varsayılan değer:	None
Gerekli:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

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

Tür:	SwitchParameter
Aliases:	wi
Position:	Named
varsayılan değer:	False
Gerekli:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Girişler

String

Parametreler: Abonelik (ByValue)

Çıkışlar

PSAzureProfile

Aracılığıyla paylaş