다음을 통해 공유

Add-AzureAccount

  • 참조
모듈:
Azure

Windows PowerShell에 Azure 계정을 추가합니다.

참고 항목

이 설명서에서 참조되는 cmdlet은 ASM(Azure Service Manager) API를 사용하는 레거시 Azure 리소스를 관리하기 위한 것입니다. 이 레거시 PowerShell 모듈은 ASM이 사용 중지될 예정이므로 새 리소스를 만들 때 권장되지 않습니다. 자세한 내용은 Azure Service Manager 사용 중지를 참조 하세요.

Az PowerShell 모듈은 PowerShell을 사용하여 ARM(Azure Resource Manager) 리소스를 관리하는 데 권장되는 PowerShell 모듈입니다.

구문

Add-AzureAccount
   [-Environment <String>]
   [-Credential <PSCredential>]
   [-Tenant <String>]
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]
Add-AzureAccount
   [-Environment <String>]
   -Credential <PSCredential>
   [-ServicePrincipal]
   -Tenant <String>
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]

Description

Add-AzureAccount cmdlet을 사용하면 Azure 계정 및 해당 구독을 Windows PowerShell에서 사용할 수 있습니다. Windows PowerShell에서 Azure 계정에 로그인하는 것과 같습니다. 계정에서 로그아웃하려면 Remove-AzureAccount cmdlet을 사용합니다.

Add-AzureAccount 는 Azure 계정에 대한 정보를 다운로드하고 로밍 사용자 프로필의 구독 데이터 파일에 저장합니다. 또한 Windows PowerShell에서 사용자 대신 Azure 계정에 액세스할 수 있는 액세스 토큰을 가져옵니다. 명령이 완료되면 Windows PowerShell에서 Azure 계정을 관리할 수 있습니다.

Windows PowerShell에서 Azure 계정을 사용할 수 있도록 하는 방법에는 두 가지가 있습니다. Microsoft Entra 인증 액세스 토큰을 사용하는 Add-AzureAccount cmdlet 또는 관리 인증서를 사용하는 Import-AzurePublishSettingsFile을 사용할 수 있습니다. 사용할 방법에 대한 지침은 방법: 구독에 연결(https://azure.microsoft.com/documentation/articles/install-configure-powershell/#Connect)을 참조하세요.

Add-AzureAccount를 실행하면 Azure 계정에 로그인하라는 대화형 창이 표시됩니다. 이 로그인은 액세스 토큰이 만료될 때까지 유효합니다. 만료되면 계정에 액세스해야 하는 cmdlet은 Add-AzureAccount를 다시 실행 하라는 메시지를 표시합니다 .

이 항목에서는 Microsoft Azure PowerShell 모듈의 0.8.10 버전에 있는 cmdlet에 대해 설명합니다. 사용 중인 모듈의 버전을 얻으려면 Azure PowerShell 콘솔에서 다음을 입력합니다 (Get-Module -Name Azure).Version.

예제

예제 1: 계정 추가

PS C:\> Add-AzureAccount

이 명령은 Windows PowerShell에 Azure 계정을 추가합니다. 명령을 실행하면 계정의 사용자 이름과 암호를 요청하는 창이 나타납니다.

예제 2: 대체 구독 데이터 파일 사용

PS C:\> Add-AzureAccount -SubscriptionDataFile C:\Testing\SDF.xml

이 명령은 SubscriptionDataFile 매개 변수를 사용하여 Add-AzureAccount에 계정 데이터를 기본 파일 대신 C:\Testing\SDF.xml 파일에 저장하도록 지시합니다.

매개 변수

-Credential

형식:PSCredential
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Environment

Azure 환경을 지정합니다.

Azure 환경은 글로벌 Azure용 AzureCloud 및 중국의 21Vianet에서 운영하는 Azure용 AzureChinaCloud와 같은 Microsoft Azure의 독립적인 배포입니다. Azure 팩 및 WAPack cmdlet을 사용하여 온-프레미스 Azure 환경을 만들 수도 있습니다. 자세한 내용은 Azure 팩을 참조 하세요.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Profile

이 cmdlet이 읽는 Azure 프로필을 지정합니다. 프로필을 지정하지 않으면 이 cmdlet은 로컬 기본 프로필에서 읽습니다.

형식:AzureSMProfile
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ServicePrincipal

형식:SwitchParameter
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Tenant

형식:String
별칭:TenantId
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

입력

None

이 cmdlet에 입력을 파이프할 수 없습니다.

출력

None

이 cmdlet은 출력을 반환하지 않습니다.

참고

  • Add-AzureAccount(및 Microsoft Entra 인증 방법)가 Import-AzurePublishSettings(및 관리 인증서 방법)보다 우선합니다. 계정에서 Add-AzureAccount를 한 번만 사용하는 경우 Microsoft Entra 인증 방법이 사용되고 관리 인증서가 무시됩니다. Microsoft Entra 토큰을 제거하고 관리 인증서 메서드를 복원하려면 Remove-AzureAccount cmdlet을 사용합니다. 자세한 내용은 Get-Help Remove-AzureAccount를 입력 합니다.
  • "자격 증명이 만료되었습니다. Add-AzureAccount를 사용하여 다시 로그인하세요." 액세스 토큰이 만료되었으며 Windows PowerShell에서 Azure 계정에 액세스할 수 없음을 나타냅니다. 계정에 대한 액세스를 복원하려면 Add-AzureAccount를 다시 실행합니다.
  • Azure PowerShell 계정 및 구독 cmdlet은 라이브 Azure 계정이 아닌 구독 데이터 파일에서 데이터를 가져옵니다. Azure 관리 포털을 사용하는 등 Windows PowerShell 외부에서 계정 또는 구독을 변경하는 경우 Add-AzureAccount를 다시 실행하여 구독 데이터 파일을 새로 고칩니다.