Connect-AzureRmAccount

Referencia

Modul:: AzureRM.Profile

Csatlakozzon az Azure-hoz hitelesített fiókkal az Azure Resource Manager-parancsmagkérelmekhez.

Figyelmeztetés

Az AzureRM PowerShell-modul 2024. február 29-én hivatalosan elavult. Javasoljuk a felhasználóknak, hogy migráljanak az AzureRM-ből az Az PowerShell-modulba a folyamatos támogatás és frissítések biztosítása érdekében.

Bár az AzureRM-modul továbbra is működik, a továbbiakban nem tart fenn vagy nem támogatott, így a folyamatos használatot a felhasználó saját belátása szerint és kockázatára teheti. Az Az modulra való áttéréshez tekintse meg a migrálási erőforrásainkat.

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

A Connect-AzureRmAccount parancsmag hitelesített fiókkal csatlakozik az Azure-hoz az Azure Resource Manager-parancsmag-kérelmekhez való használatra. Ezt a hitelesített fiókot csak Azure Resource Manager-parancsmagokkal használhatja. Ha hitelesített fiókot szeretne hozzáadni a Service Management-parancsmagokkal való használathoz, használja az Add-AzureAccount vagy az Import-AzurePublishSettingsFile parancsmagot. Ha az aktuális felhasználóhoz nem található környezet, ez a parancs feltölti a felhasználó környezeti listáját az egyes (első 25) előfizetések környezetével. A felhasználó számára létrehozott környezetek listája a Get-AzureRmContext -ListAvailable parancs futtatásával érhető el. A környezeti sokaság kihagyásához futtassa ezt a parancsot a "-SkipContextPopulation" kapcsolóparaméterrel. A parancsmag végrehajtása után leválaszthatja az Azure-fiókokat a Disconnect-AzureRmAccount használatával.

Példák

1. példa: Interaktív bejelentkezés használata Azure-fiókhoz való csatlakozáshoz

PS C:\> Connect-AzureRmAccount

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

Ez a parancs egy Azure-fiókhoz csatlakozik. Ha azure Resource Manager-parancsmagokat szeretne futtatni ezzel a fiókkal, a parancssorban meg kell adnia a Microsoft-fiók vagy a szervezeti azonosító hitelesítő adatait. Ha a hitelesítő adatokhoz engedélyezve van a többtényezős hitelesítés, be kell jelentkeznie az interaktív beállítással, vagy szolgáltatásnév-hitelesítést kell használnia.

2. példa: Csatlakozás Azure-fiókhoz szervezeti azonosító hitelesítő adatokkal

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

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

Az első parancs felhasználói hitelesítő adatokat (felhasználónevet és jelszót) kér, majd azokat a $Credential változóban tárolja. A második parancs a $Credential tárolt hitelesítő adatokkal csatlakozik egy Azure-fiókhoz. Ez a fiók szervezeti azonosító hitelesítő adatokkal hitelesíti az Azure Resource Managert. Ezzel a fiókkal nem futtathat Azure Resource Manager-parancsmagokat többtényezős hitelesítéssel vagy Microsoft-fiók hitelesítő adataival.

3. példa: Csatlakozás azure-szolgáltatásnév-fiókhoz

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

Az első parancs lekéri a szolgáltatásnév hitelesítő adatait (az alkalmazásazonosítót és a szolgáltatásnév titkos kódját), majd azokat a $Credential változóban tárolja. A második parancs a megadott bérlő $Credential tárolt szolgáltatásnév hitelesítő adataival csatlakozik az Azure-hoz. A ServicePrincipal kapcsolóparaméter azt jelzi, hogy a fiók szolgáltatásnévként hitelesít.

4. példa: Interaktív bejelentkezés használata egy adott bérlőhöz és előfizetéshez tartozó fiókhoz való csatlakozáshoz

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

Ez a parancs egy Azure-fiókhoz csatlakozik, és konfigurálta az AzureRM PowerShellt, hogy alapértelmezés szerint a megadott bérlőhöz és előfizetéshez tartozó parancsmagokat futtassa.

5. példa: Fiók hozzáadása felügyeltszolgáltatás-identitás bejelentkezéssel

PS C:\> Connect-AzureRmAccount -MSI

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

Ez a parancs a gazdagépkörnyezet felügyeltszolgáltatás-identitásával csatlakozik (például ha egy VirtualMachine-on van végrehajtva egy hozzárendelt felügyeltszolgáltatás-identitással, ez lehetővé teszi a kód számára, hogy ezzel a hozzárendelt identitással jelentkezzen be)

6. példa: Fiók hozzáadása tanúsítványok használatával

# 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

Ez a parancs tanúsítványalapú szolgáltatásnév-hitelesítéssel csatlakozik egy Azure-fiókhoz. A hitelesítéshez használt szolgáltatásnevet a megadott tanúsítvánnyal kellett létrehozni.

Paraméterek

-AccessToken

Hozzáférési jogkivonatot ad meg.

Típus:	String
Position:	Named
Alapértelmezett érték:	None
Kötelező:	True
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-AccountId

Hozzáférési jogkivonat fiókazonosítója

Típus:	String
Position:	Named
Alapértelmezett érték:	None
Kötelező:	True
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-ApplicationId

EGYSZERŰ SZOLGÁLTATÁSNÉV

Típus:	String
Position:	Named
Alapértelmezett érték:	None
Kötelező:	True
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-CertificateThumbprint

Tanúsítványkivonat (ujjlenyomat)

Típus:	String
Position:	Named
Alapértelmezett érték:	None
Kötelező:	True
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-Confirm

Jóváhagyást kér a parancsmag futtatása előtt.

Típus:	SwitchParameter
Aliasok:	cf
Position:	Named
Alapértelmezett érték:	False
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-ContextName

A bejelentkezés alapértelmezett környezetének neve. Ezt a környezetet a bejelentkezés után ezen a néven választhatja ki.

Típus:	String
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-Credential

PSCredential objektumot ad meg. A PSCredential objektummal kapcsolatos további információkért írja be a Get-Help Get-Credential parancsot. A PSCredential objektum megadja a felhasználói azonosítót és a jelszót a szervezeti azonosító hitelesítő adataihoz, vagy az alkalmazásazonosítót és a szolgáltatásnév hitelesítő adatainak titkos kulcsát.

Típus:	PSCredential
Position:	0
Alapértelmezett érték:	None
Kötelező:	True
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-DefaultProfile

Az Azure-ral való kommunikációhoz használt hitelesítő adatok, fiók, bérlő és előfizetés.

Típus:	IAzureContextContainer
Aliasok:	AzureRmContext, AzureCredential
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-Environment

A bejelentkezéshez használandó fiókot tartalmazó környezet

Típus:	String
Aliasok:	EnvironmentName
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-Force

Írja felül a meglévő környezetet ugyanazzal a névvel, ha van ilyen.

Típus:	SwitchParameter
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-GraphAccessToken

AccessToken for Graph Service

Típus:	String
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-Identity

Bejelentkezés felügyeltszolgáltatás-identitással az aktuális környezetben.

Típus:	SwitchParameter
Aliasok:	MSI, ManagedService
Position:	Named
Alapértelmezett érték:	None
Kötelező:	True
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-KeyVaultAccessToken

AccessToken for KeyVault Service

Típus:	String
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-ManagedServiceHostName

Felügyelt szolgáltatás bejelentkezésének állomásneve

Típus:	String
Position:	Named
Alapértelmezett érték:	localhost
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-ManagedServicePort

Felügyelt szolgáltatás bejelentkezésének portszáma

Típus:	Int32
Position:	Named
Alapértelmezett érték:	50342
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-ManagedServiceSecret

Titkos kód, amelyet valamilyen felügyelt szolgáltatás bejelentkezéséhez használnak.

Típus:	SecureString
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-Scope

Meghatározza a környezeti változások hatókörét, például azt, hogy a módosítások csak az aktuális folyamatra vagy a felhasználó által indított összes munkamenetre vonatkoznak-e.

Típus:	ContextModificationScope
Elfogadott értékek:	Process, CurrentUser
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-ServicePrincipal

Azt jelzi, hogy ez a fiók a szolgáltatásnév hitelesítő adatainak megadásával hitelesít.

Típus:	SwitchParameter
Position:	Named
Alapértelmezett érték:	None
Kötelező:	True
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-SkipContextPopulation

Kihagyja a környezetek sokaságát, ha nem található környezet.

Típus:	SwitchParameter
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-SkipValidation

Hozzáférési jogkivonat érvényesítésének kihagyása

Típus:	SwitchParameter
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-Subscription

Előfizetés neve vagy azonosítója

Típus:	String
Aliasok:	SubscriptionName, SubscriptionId
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	True
Helyettesítő karakterek elfogadása:	False

-TenantId

Nem kötelező tartománynév vagy bérlőazonosító. A tartománynév nem működik minden bejelentkezési helyzetben. A Felhőszolgáltató (CSP) bejelentkezéséhez bérlőazonosító szükséges.

Típus:	String
Aliasok:	Domain
Position:	Named
Alapértelmezett érték:	None
Kötelező:	True
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-WhatIf

Bemutatja, mi történne a parancsmag futtatásakor. A parancsmag nem fut.

Típus:	SwitchParameter
Aliasok:	wi
Position:	Named
Alapértelmezett érték:	False
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

Bevitelek

String

Paraméterek: Előfizetés (ByValue)

Kimenetek

PSAzureProfile

Megosztás a következőn keresztül: