Share via


Get-AzureEnvironment

Azure 환경을 가져옵니다.

참고

이 설명서에서 참조하는 cmdlet은 Service Management API를 사용하는 레거시 Azure 리소스를 관리하기 위한 것입니다. Azure Resource Manager 리소스를 관리하는 cmdlet은 Az PowerShell 모듈을 참조하세요.

Syntax

Get-AzureEnvironment
   [-Name <String>]
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]

Description

Get-AzureEnvironment cmdlet은 Windows PowerShell에서 사용할 수 있는 Azure 환경을 가져옵니다.

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

Get-AzureEnvironment cmdlet은 Azure가 아닌 구독 데이터 파일에서 환경을 가져옵니다. 구독 데이터 파일이 오래된 경우 Add-AzureAccount 또는 Import-PublishSettingsFile cmdlet을 실행하여 새로 고칩니다.

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

예제

예제 1: 모든 환경 가져오기

PS C:\> Get-AzureEnvironment

EnvironmentName               ServiceEndpoint               ResourceManagerEndpoint       PublishSettingsFileUrl
---------------               ---------------               -----------------------       ----------------------

AzureCloud                    https://management.core.wi... https://management.azure.com/ https://go.microsoft.com/fw...
AzureChinaCloud               https://management.core.ch... https://not-supported-serv... https://go.microsoft.com/fw...

이 명령은 Windows PowerShell에서 사용할 수 있는 모든 환경을 가져옵니다.

예제 2: 이름으로 환경 가져오기

PS C:\> Get-AzureEnvironment -Name AzureCloud

Name                          : AzureCloud

PublishSettingsFileUrl        : https://go.microsoft.com/fwlink/?LinkID=301775

ServiceEndpoint               : https://management.core.windows.net/

ResourceManagerEndpoint       : https://management.azure.com/

ManagementPortalUrl           : https://go.microsoft.com/fwlink/?LinkId=254433

ActiveDirectoryEndpoint       : https://login.windows.net/

ActiveDirectoryCommonTenantId : common

StorageEndpointSuffix         : core.windows.net

StorageBlobEndpointFormat     : {0}://{1}.blob.core.windows.net/

StorageQueueEndpointFormat    : {0}://{1}.queue.core.windows.net/

StorageTableEndpointFormat    : {0}://{1}.table.core.windows.net/

GalleryEndpoint               : https://gallery.azure.com/

이 예제에서는 AzureCloud 환경을 가져옵니다.

예제 3: 모든 환경의 모든 속성 가져오기

PS C:\> Get-AzureEnvironment | ForEach-Object {Get-AzureEnvironment -Name $_.EnvironmentName}

이 명령은 모든 환경의 모든 속성을 가져옵니다.

이 명령은 Get-AzureEnvironment cmdlet을 사용하여 이 계정에 대한 모든 Azure 환경을 가져옵니다. 그런 다음 Foreach-Object cmdlet을 사용하여 각 환경에서 Name 매개 변수를 사용하여 Get-AzureEnvironment 명령을 실행합니다. Name 매개 변수의 값은 각 환경의 EnvironmentName 속성입니다.

매개 변수 가 없으면 Get-AzureEnvironment 는 환경의 선택한 속성만 가져옵니다.

매개 변수

-Name

지정된 환경만 가져옵니다. 환경 이름을 입력합니다. 매개 변수 값은 대/소문자를 구분합니다. 와일드카드 문자는 허용되지 않습니다.

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

-Profile

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

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

입력

None

속성 이름으로 이 cmdlet에 입력을 파이프할 수 있지만 값으로는 파이프할 수 없습니다.

출력

PSCustomObject

기본적으로 Get-AzureEnvironment 는 사용자 지정 개체를 반환합니다.

Microsoft.WindowsAzure.Commands.Utilities.Common.WindowsAzureEnvironment

Name 매개 변수를 사용하여 Get-AzureEnvironment실행하면 WindowsAzureEnvironment 개체가 반환됩니다.