Connect-AzureRmAccount

Referentie

Module:: AzureRM.Profile

Verbinding maken naar Azure met een geverifieerd account voor gebruik met Azure Resource Manager-cmdlet-aanvragen.

Waarschuwing

De AzureRM PowerShell-module is vanaf 29 februari 2024 officieel afgeschaft. Gebruikers wordt aangeraden om van AzureRM naar de Az PowerShell-module te migreren om ondersteuning en updates te garanderen.

Hoewel de AzureRM-module nog steeds kan functioneren, wordt deze niet meer onderhouden of ondersteund, waardoor het gebruik naar eigen goeddunken en risico van de gebruiker blijft bestaan. Raadpleeg onze migratiebronnen voor hulp bij de overgang naar de Az-module.

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

De cmdlet Verbinding maken-AzureRmAccount maakt verbinding met Azure met een geverifieerd account voor gebruik met Azure Resource Manager-cmdlet-aanvragen. U kunt dit geverifieerde account alleen gebruiken met Azure Resource Manager-cmdlets. Als u een geverifieerd account wilt toevoegen voor gebruik met Service Management-cmdlets, gebruikt u de cmdlet Add-AzureAccount of import-AzurePublish Instellingen File. Als er geen context wordt gevonden voor de huidige gebruiker, wordt met deze opdracht de contextlijst van de gebruiker gevuld met een context voor elk van hun (eerste 25) abonnementen. De lijst met contexten die voor de gebruiker zijn gemaakt, vindt u door Get-AzureRmContext -ListAvailable uit te voeren. Als u deze contextpopulatie wilt overslaan, kunt u deze opdracht uitvoeren met de schakelparameter -SkipContextPopulation. Nadat u deze cmdlet hebt uitgevoerd, kunt u de verbinding met een Azure-account verbreken met behulp van Disconnect-AzureRmAccount.

Voorbeelden

Voorbeeld 1: Een interactieve aanmelding gebruiken om verbinding te maken met een Azure-account

PS C:\> Connect-AzureRmAccount

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

Met deze opdracht wordt verbinding gemaakt met een Azure-account. Als u Azure Resource Manager-cmdlets wilt uitvoeren met dit account, moet u referenties voor Microsoft-account of organisatie-id opgeven bij de prompt. Als meervoudige verificatie is ingeschakeld voor uw referenties, moet u zich aanmelden met behulp van de interactieve optie of service-principal-verificatie gebruiken.

Voorbeeld 2: Verbinding maken naar een Azure-account met behulp van organisatie-id-referenties

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

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

De eerste opdracht vraagt om gebruikersreferenties (gebruikersnaam en wachtwoord) en slaat deze vervolgens op in de variabele $Credential. De tweede opdracht maakt verbinding met een Azure-account met behulp van de referenties die zijn opgeslagen in $Credential. Dit account wordt geverifieerd met Azure Resource Manager met behulp van organisatie-id-referenties. U kunt meervoudige verificatie of Microsoft-accountreferenties niet gebruiken om Azure Resource Manager-cmdlets uit te voeren met dit account.

Voorbeeld 3: Verbinding maken naar een Azure-service-principal-account

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

Met de eerste opdracht worden de referenties van de service-principal opgehaald (toepassings-id en geheim van de service-principal) en worden deze vervolgens opgeslagen in de $Credential variabele. De tweede opdracht maakt verbinding met Azure met behulp van de referenties van de service-principal die zijn opgeslagen in $Credential voor de opgegeven tenant. De parameter ServicePrincipal-switch geeft aan dat het account wordt geverifieerd als een service-principal.

Voorbeeld 4: Een interactieve aanmelding gebruiken om verbinding te maken met een account voor een specifieke tenant en een specifiek abonnement

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

Met deze opdracht maakt u verbinding met een Azure-account en hebt u AzureRM PowerShell geconfigureerd om standaard cmdlets uit te voeren voor de opgegeven tenant en het opgegeven abonnement.

Voorbeeld 5: Een account toevoegen met managed service identity-aanmelding

PS C:\> Connect-AzureRmAccount -MSI

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

Met deze opdracht wordt verbinding gemaakt met behulp van de beheerde service-identiteit van de hostomgeving (bijvoorbeeld als deze wordt uitgevoerd op een virtuele machine met een toegewezen beheerde service-identiteit, wordt de code toegestaan om zich aan te melden met die toegewezen identiteit)

Voorbeeld 6: Een account toevoegen met behulp van certificaten

# 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

Met deze opdracht wordt verbinding gemaakt met een Azure-account met behulp van verificatie op basis van een service-principal op basis van certificaten. De service-principal die voor verificatie wordt gebruikt, moet zijn gemaakt met het opgegeven certificaat.

Parameters

-AccessToken

Hiermee geeft u een toegangstoken op.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-AccountId

Account-id voor toegangstoken

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-ApplicationId

SPN

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-CertificateThumbprint

Certificaat-hash (vingerafdruk)

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ContextName

Naam van de standaardcontext uit deze aanmelding. U kunt deze context na aanmelding selecteren op deze naam.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Credential

Hiermee geeft u een PSCredential-object. Voor meer informatie over het PSCredential-object typt u Get-Help Get-Credential. Het PSCredential-object biedt de gebruikers-id en het wachtwoord voor organisatie-id-referenties, of de toepassings-id en het geheim voor referenties van de service-principal.

Type:	PSCredential
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultProfile

De referenties, het account, de tenant en het abonnement die worden gebruikt voor communicatie met Azure.

Type:	IAzureContextContainer
Aliases:	AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Environment

Omgeving met het account om u aan te melden

Type:	String
Aliases:	EnvironmentName
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Force

Overschrijf de bestaande context met dezelfde naam, indien van toepassing.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-GraphAccessToken

AccessToken voor Graph Service

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Identity

Meld u aan met beheerde service-identiteit in de huidige omgeving.

Type:	SwitchParameter
Aliases:	MSI, ManagedService
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-KeyVaultAccessToken

AccessToken voor KeyVault-service

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ManagedServiceHostName

Hostnaam voor aanmelding bij beheerde service

Type:	String
Position:	Named
Default value:	localhost
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ManagedServicePort

Poortnummer voor aanmelding bij beheerde service

Type:	Int32
Position:	Named
Default value:	50342
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ManagedServiceSecret

Geheim, gebruikt voor bepaalde soorten beheerde serviceaanmelding.

Type:	SecureString
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Scope

Bepaalt het bereik van contextwijzigingen, bijvoorbeeld of wijzigingen alleen van toepassing zijn op het huidige proces of op alle sessies die door deze gebruiker zijn gestart.

Type:	ContextModificationScope
Accepted values:	Process, CurrentUser
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ServicePrincipal

Geeft aan dat dit account wordt geverifieerd door referenties voor de service-principal op te geven.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-SkipContextPopulation

Hiermee wordt de contextpopulatie overgeslagen als er geen contexten worden gevonden.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SkipValidation

Validatie voor toegangstoken overslaan

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Subscription

Abonnementsnaam of -id

Type:	String
Aliases:	SubscriptionName, SubscriptionId
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-TenantId

Optionele domeinnaam of tenant-id. Domeinnaam werkt niet in alle aanmeldingssituaties. Voor CSP-aanmelding (Cloud Solution Provider) is tenant-id vereist.

Type:	String
Aliases:	Domain
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Invoerwaarden

String

Parameters: Abonnement (ByValue)

Uitvoerwaarden

PSAzureProfile