Connect-AzureRmAccount

참조

모듈:: AzureRM.Profile

Azure Resource Manager cmdlet 요청에 사용할 인증된 계정으로 Azure에 커넥트.

Warning

AzureRM PowerShell 모듈은 2024년 2월 29일부터 공식적으로 사용되지 않습니다. 사용자는 지속적인 지원 및 업데이트를 보장하기 위해 AzureRM에서 Az PowerShell 모듈로 마이그레이션하는 것이 좋습니다.

AzureRM 모듈은 여전히 작동할 수 있지만 더 이상 기본 또는 지원되지 않으므로 사용자의 재량에 따라 계속 사용할 수 있습니다. Az 모듈로 전환하는 방법에 대한 지침은 마이그레이션 리소스를 참조하세요.

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

커넥트-AzureRmAccount cmdlet은 Azure Resource Manager cmdlet 요청에 사용할 인증된 계정으로 Azure에 연결합니다. 이 인증된 계정은 Azure Resource Manager cmdlet에서만 사용할 수 있습니다. 서비스 관리 cmdlet에 사용할 인증된 계정을 추가하려면 Add-AzureAccount 또는 Import-AzurePublish설정File cmdlet을 사용합니다. 현재 사용자에 대한 컨텍스트가 없는 경우 이 명령은 사용자의 컨텍스트 목록을 각 구독(처음 25개) 구독에 대한 컨텍스트로 채웁니다. 사용자에 대해 만든 컨텍스트 목록은 "Get-AzureRmContext -ListAvailable"을 실행하여 찾을 수 있습니다. 이 컨텍스트 채우기를 건너뛰려면 "-SkipContextPopulation" 스위치 매개 변수를 사용하여 이 명령을 실행할 수 있습니다. 이 cmdlet을 실행한 후 Disconnect-AzureRmAccount를 사용하여 Azure 계정에서 연결을 끊을 수 있습니다.

예제

예제 1: 대화형 로그인을 사용하여 Azure 계정에 연결

PS C:\> Connect-AzureRmAccount

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

이 명령은 Azure 계정에 연결합니다. 이 계정으로 Azure Resource Manager cmdlet을 실행하려면 프롬프트에서 Microsoft 계정 또는 조직 ID 자격 증명을 제공해야 합니다. 자격 증명에 다단계 인증을 사용하는 경우 대화형 옵션을 사용하여 로그인하거나 서비스 주체 인증을 사용해야 합니다.

예제 2: 조직 ID 자격 증명을 사용하여 Azure 계정에 커넥트

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

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

첫 번째 명령은 사용자 자격 증명(사용자 이름 및 암호)을 묻는 메시지를 표시한 다음 $Credential 변수에 저장합니다. 두 번째 명령은 $Credential 저장된 자격 증명을 사용하여 Azure 계정에 연결합니다. 이 계정은 조직 ID 자격 증명을 사용하여 Azure Resource Manager에서 인증합니다. 다단계 인증 또는 Microsoft 계정 자격 증명을 사용하여 이 계정으로 Azure Resource Manager cmdlet을 실행할 수 없습니다.

예제 3: 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

첫 번째 명령은 서비스 주체 자격 증명(애플리케이션 ID 및 서비스 주체 암호)을 가져오고 $Credential 변수에 저장합니다. 두 번째 명령은 지정된 테넌트에 대한 $Credential 저장된 서비스 주체 자격 증명을 사용하여 Azure에 연결합니다. ServicePrincipal 스위치 매개 변수는 계정이 서비스 주체로 인증됨을 나타냅니다.

예제 4: 대화형 로그인을 사용하여 특정 테넌트 및 구독의 계정에 연결

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

이 명령은 Azure 계정에 연결하고 기본적으로 지정된 테넌트 및 구독에 대한 cmdlet을 실행하도록 AzureRM PowerShell을 구성합니다.

예제 5: 관리 서비스 ID 로그인을 사용하여 계정 추가

PS C:\> Connect-AzureRmAccount -MSI

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

이 명령은 호스트 환경의 관리 서비스 ID를 사용하여 연결합니다(예: 할당된 관리 서비스 ID가 있는 VirtualMachine에서 실행되는 경우 코드가 할당된 ID를 사용하여 로그인할 수 있도록 허용).

예제 6: 인증서를 사용하여 계정 추가

# 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

이 명령은 인증서 기반 서비스 주체 인증을 사용하여 Azure 계정에 연결합니다. 인증에 사용되는 서비스 주체는 지정된 인증서를 사용하여 만들어야 합니다.

매개 변수

-AccessToken

액세스 토큰을 지정합니다.

형식:	String
Position:	Named
기본값:	None
필수:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-AccountId

액세스 토큰의 계정 ID

형식:	String
Position:	Named
기본값:	None
필수:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-ApplicationId

SPN

형식:	String
Position:	Named
기본값:	None
필수:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-CertificateThumbprint

인증서 해시(지문)

형식:	String
Position:	Named
기본값:	None
필수:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

cmdlet을 실행하기 전에 확인 메시지가 표시됩니다.

형식:	SwitchParameter
Aliases:	cf
Position:	Named
기본값:	False
필수:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ContextName

이 로그인의 기본 컨텍스트 이름입니다. 로그인 후 이 이름으로 이 컨텍스트를 선택할 수 있습니다.

형식:	String
Position:	Named
기본값:	None
필수:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Credential

PSCredential 개체를 지정합니다. PSCredential 개체에 대한 자세한 내용은 Get-Help Get-Credential을 입력합니다. PSCredential 개체는 조직 ID 자격 증명에 대한 사용자 ID 및 암호 또는 서비스 주체 자격 증명에 대한 애플리케이션 ID 및 비밀을 제공합니다.

형식:	PSCredential
Position:	0
기본값:	None
필수:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultProfile

Azure와의 통신에 사용되는 자격 증명, 계정, 테넌트 및 구독입니다.

형식:	IAzureContextContainer
Aliases:	AzureRmContext, AzureCredential
Position:	Named
기본값:	None
필수:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Environment

로그인할 계정이 포함된 환경

형식:	String
Aliases:	EnvironmentName
Position:	Named
기본값:	None
필수:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Force

동일한 이름으로 기존 컨텍스트를 덮어씁합니다(있는 경우).

형식:	SwitchParameter
Position:	Named
기본값:	None
필수:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-GraphAccessToken

Graph 서비스에 대한 AccessToken

형식:	String
Position:	Named
기본값:	None
필수:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Identity

현재 환경에서 관리 서비스 ID를 사용하여 로그인합니다.

형식:	SwitchParameter
Aliases:	MSI, ManagedService
Position:	Named
기본값:	None
필수:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-KeyVaultAccessToken

KeyVault 서비스에 대한 AccessToken

형식:	String
Position:	Named
기본값:	None
필수:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ManagedServiceHostName

관리 서비스 로그인의 호스트 이름

형식:	String
Position:	Named
기본값:	localhost
필수:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ManagedServicePort

관리 서비스 로그인의 포트 번호

형식:	Int32
Position:	Named
기본값:	50342
필수:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ManagedServiceSecret

일종의 관리 서비스 로그인에 사용되는 비밀입니다.

형식:	SecureString
Position:	Named
기본값:	None
필수:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Scope

예를 들어 변경 내용이 현재 프로세스에만 적용되는지 아니면 이 사용자가 시작한 모든 세션에만 적용되는지와 같은 컨텍스트 변경 범위를 결정합니다.

형식:	ContextModificationScope
허용되는 값:	Process, CurrentUser
Position:	Named
기본값:	None
필수:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ServicePrincipal

서비스 주체 자격 증명을 제공하여 이 계정이 인증됨을 나타냅니다.

형식:	SwitchParameter
Position:	Named
기본값:	None
필수:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-SkipContextPopulation

컨텍스트가 없는 경우 컨텍스트 채우기를 건너뜁니다.

형식:	SwitchParameter
Position:	Named
기본값:	None
필수:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SkipValidation

액세스 토큰에 대한 유효성 검사 건너뛰기

형식:	SwitchParameter
Position:	Named
기본값:	None
필수:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Subscription

구독 이름 또는 ID

형식:	String
Aliases:	SubscriptionName, SubscriptionId
Position:	Named
기본값:	None
필수:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-TenantId

선택적 do기본 이름 또는 테넌트 ID입니다. Do기본 이름은 모든 로그인 상황에서 작동하지 않습니다. CSP(클라우드 솔루션 공급자) 로그인의 경우 테넌트 ID가 필요합니다.

형식:	String
Aliases:	Domain
Position:	Named
기본값:	None
필수:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

cmdlet이 실행될 경우 결과 동작을 표시합니다. cmdlet이 실행되지 않습니다.

형식:	SwitchParameter
Aliases:	wi
Position:	Named
기본값:	False
필수:	False
Accept pipeline input:	False
Accept wildcard characters:	False

입력

String

매개 변수: 구독(ByValue)

출력

PSAzureProfile

다음을 통해 공유