Connect-AzureRmAccount

Referens

Modul:: AzureRM.Profile

Anslut till Azure med ett autentiserat konto för användning med Azure Resource Manager-cmdlet-begäranden.

Varning

AzureRM PowerShell-modulen är officiellt inaktuell från och med den 29 februari 2024. Användare rekommenderas att migrera från AzureRM till Az PowerShell-modulen för att säkerställa fortsatt support och uppdateringar.

Även om AzureRM-modulen fortfarande kan fungera, underhålls den inte längre eller stöds, vilket gör att användaren kan välja och riskera fortsatt användning. Se våra migreringsresurser för vägledning om övergången till Az-modulen.

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

Cmdleten Anslut-AzureRmAccount ansluter till Azure med ett autentiserat konto för användning med Azure Resource Manager-cmdlet-begäranden. Du kan endast använda det här autentiserade kontot med Azure Resource Manager-cmdletar. Om du vill lägga till ett autentiserat konto för användning med Service Management-cmdletar använder du cmdleten Add-AzureAccount eller Import-AzurePublish Inställningar File. Om ingen kontext hittas för den aktuella användaren fyller det här kommandot i användarens kontextlista med en kontext för var och en av deras (första 25) prenumerationer. Listan över kontexter som skapats för användaren finns genom att köra "Get-AzureRmContext -ListAvailable". Om du vill hoppa över den här kontextpopulationen kan du köra det här kommandot med växelparametern "-SkipContextPopulation". När du har kört den här cmdleten kan du koppla från ett Azure-konto med hjälp av Disconnect-AzureRmAccount.

Exempel

Exempel 1: Använd en interaktiv inloggning för att ansluta till ett Azure-konto

PS C:\> Connect-AzureRmAccount

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

Det här kommandot ansluter till ett Azure-konto. Om du vill köra Azure Resource Manager-cmdletar med det här kontot måste du ange autentiseringsuppgifter för Microsoft-konto eller organisations-ID i prompten. Om multifaktorautentisering är aktiverat för dina autentiseringsuppgifter måste du logga in med det interaktiva alternativet eller använda autentisering med tjänstens huvudnamn.

Exempel 2: Anslut till ett Azure-konto med autentiseringsuppgifter för organisations-ID

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

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

Det första kommandot frågar efter autentiseringsuppgifter (användarnamn och lösenord) och lagrar dem sedan i variabeln $Credential. Det andra kommandot ansluter till ett Azure-konto med hjälp av autentiseringsuppgifterna som lagras i $Credential. Det här kontot autentiserar med Azure Resource Manager med autentiseringsuppgifter för organisations-ID. Du kan inte använda autentiseringsuppgifter för flera faktorer eller Microsoft-konto för att köra Azure Resource Manager-cmdletar med det här kontot.

Exempel 3: Anslut till ett konto för tjänstens huvudnamn i Azure

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

Det första kommandot hämtar autentiseringsuppgifterna för tjänstens huvudnamn (program-ID och tjänstens huvudnamnshemlighet) och lagrar dem sedan i variabeln $Credential. Det andra kommandot ansluter till Azure med autentiseringsuppgifterna för tjänstens huvudnamn som lagras i $Credential för den angivna klientorganisationen. Parametern ServicePrincipal switch anger att kontot autentiseras som tjänstens huvudnamn.

Exempel 4: Använd en interaktiv inloggning för att ansluta till ett konto för en specifik klientorganisation och prenumeration

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

Det här kommandot ansluter till ett Azure-konto och konfigurerar AzureRM PowerShell för att köra cmdletar för den angivna klientorganisationen och prenumerationen som standard.

Exempel 5: Lägg till ett konto med hanterad tjänstidentitetsinloggning

PS C:\> Connect-AzureRmAccount -MSI

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

Det här kommandot ansluter med värdmiljöns hanterade tjänstidentitet (om det till exempel körs på en VirtualMachine med en tilldelad hanterad tjänstidentitet tillåter detta att koden loggar in med den tilldelade identiteten)

Exempel 6: Lägg till ett konto med hjälp av certifikat

# 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

Det här kommandot ansluter till ett Azure-konto med certifikatbaserad autentisering med tjänstens huvudnamn. Tjänstens huvudnamn som används för autentisering bör ha skapats med det angivna certifikatet.

Parametrar

-AccessToken

Anger en åtkomsttoken.

Typ:	String
Position:	Named
standardvärde:	None
Obligatorisk:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-AccountId

Konto-ID för åtkomsttoken

Typ:	String
Position:	Named
standardvärde:	None
Obligatorisk:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-ApplicationId

SPN

Typ:	String
Position:	Named
standardvärde:	None
Obligatorisk:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-CertificateThumbprint

Certifikathash (tumavtryck)

Typ:	String
Position:	Named
standardvärde:	None
Obligatorisk:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Typ:	SwitchParameter
Aliases:	cf
Position:	Named
standardvärde:	False
Obligatorisk:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ContextName

Namnet på standardkontexten från den här inloggningen. Du kommer att kunna välja den här kontexten med det här namnet efter inloggningen.

Typ:	String
Position:	Named
standardvärde:	None
Obligatorisk:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Credential

Anger ett PSCredential-objekt. Mer information om PSCredential-objektet finns i Get-Help Get-Credential. PSCredential-objektet tillhandahåller användar-ID och lösenord för autentiseringsuppgifter för organisations-ID eller program-ID och hemlighet för autentiseringsuppgifter för tjänstens huvudnamn.

Typ:	PSCredential
Position:	0
standardvärde:	None
Obligatorisk:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure.

Typ:	IAzureContextContainer
Aliases:	AzureRmContext, AzureCredential
Position:	Named
standardvärde:	None
Obligatorisk:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Environment

Miljö som innehåller kontot som ska loggas in på

Typ:	String
Aliases:	EnvironmentName
Position:	Named
standardvärde:	None
Obligatorisk:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Force

Skriv över den befintliga kontexten med samma namn, om det finns något.

Typ:	SwitchParameter
Position:	Named
standardvärde:	None
Obligatorisk:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-GraphAccessToken

AccessToken för Graph Service

Typ:	String
Position:	Named
standardvärde:	None
Obligatorisk:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Identity

Logga in med hanterad tjänstidentitet i den aktuella miljön.

Typ:	SwitchParameter
Aliases:	MSI, ManagedService
Position:	Named
standardvärde:	None
Obligatorisk:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-KeyVaultAccessToken

AccessToken för KeyVault-tjänsten

Typ:	String
Position:	Named
standardvärde:	None
Obligatorisk:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ManagedServiceHostName

Värdnamn för inloggning med hanterad tjänst

Typ:	String
Position:	Named
standardvärde:	localhost
Obligatorisk:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ManagedServicePort

Portnummer för inloggning med hanterad tjänst

Typ:	Int32
Position:	Named
standardvärde:	50342
Obligatorisk:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ManagedServiceSecret

Hemlighet som används för vissa typer av inloggning med hanterade tjänster.

Typ:	SecureString
Position:	Named
standardvärde:	None
Obligatorisk:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Scope

Avgör omfånget för kontextändringar, till exempel om ändringar endast gäller för den aktuella processen eller för alla sessioner som startas av den här användaren.

Typ:	ContextModificationScope
accepterade värden:	Process, CurrentUser
Position:	Named
standardvärde:	None
Obligatorisk:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ServicePrincipal

Anger att det här kontot autentiserar genom att ange autentiseringsuppgifter för tjänstens huvudnamn.

Typ:	SwitchParameter
Position:	Named
standardvärde:	None
Obligatorisk:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-SkipContextPopulation

Hoppar över kontextpopulationen om inga kontexter hittas.

Typ:	SwitchParameter
Position:	Named
standardvärde:	None
Obligatorisk:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SkipValidation

Hoppa över validering för åtkomsttoken

Typ:	SwitchParameter
Position:	Named
standardvärde:	None
Obligatorisk:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Subscription

Prenumerationsnamn eller ID

Typ:	String
Aliases:	SubscriptionName, SubscriptionId
Position:	Named
standardvärde:	None
Obligatorisk:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-TenantId

Valfritt domännamn eller klient-ID. Domännamnet fungerar inte i alla inloggningssituationer. För inloggning med Molnlösningsleverantör (CSP) krävs klientorganisations-ID.

Typ:	String
Aliases:	Domain
Position:	Named
standardvärde:	None
Obligatorisk:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

Typ:	SwitchParameter
Aliases:	wi
Position:	Named
standardvärde:	False
Obligatorisk:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Indata

String

Parametrar: Prenumeration (ByValue)

Utdata

PSAzureProfile

Dela via