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 Connect-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-AzurePublishSettingsFile. 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: Ansluta 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: Ansluta 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 = "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

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
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-AccountId

Konto-ID för åtkomsttoken

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-ApplicationId

SPN

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-CertificateThumbprint

Certifikathash (tumavtryck)

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-Confirm

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

Typ:	SwitchParameter
Alias:	cf
Position:	Named
Standardvärde:	False
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	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
Godkänn pipeline-indata:	False
Godkänn jokertecken:	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
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-DefaultProfile

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

Typ:	IAzureContextContainer
Alias:	AzureRmContext, AzureCredential
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-Environment

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

Typ:	String
Alias:	EnvironmentName
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-Force

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

Typ:	SwitchParameter
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-GraphAccessToken

AccessToken för Graph Service

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-Identity

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

Typ:	SwitchParameter
Alias:	MSI, ManagedService
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-KeyVaultAccessToken

AccessToken för KeyVault-tjänsten

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-ManagedServiceHostName

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

Typ:	String
Position:	Named
Standardvärde:	localhost
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-ManagedServicePort

Portnummer för inloggning med hanterad tjänst

Typ:	Int32
Position:	Named
Standardvärde:	50342
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	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
Godkänn pipeline-indata:	False
Godkänn jokertecken:	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
Godkända värden:	Process, CurrentUser
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	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
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-SkipContextPopulation

Hoppar över kontextpopulationen om inga kontexter hittas.

Typ:	SwitchParameter
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-SkipValidation

Hoppa över validering för åtkomsttoken

Typ:	SwitchParameter
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-Subscription

Prenumerationsnamn eller ID

Typ:	String
Alias:	SubscriptionName, SubscriptionId
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-TenantId

Valfritt domännamn eller klient-ID. Domännamnet fungerar inte i alla inloggningssituationer. För inloggning med Dobavljač rešenja u oblaku (CSP) krävs klientorganisations-ID.

Typ:	String
Alias:	Domain
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-WhatIf

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

Typ:	SwitchParameter
Alias:	wi
Position:	Named
Standardvärde:	False
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

Indata

String

Parametrar: Prenumeration (ByValue)

Utdata

PSAzureProfile

Dela via