Add-AzureEnvironment
Azure 환경을 만듭니다.
참고 항목
이 설명서에서 참조되는 cmdlet은 ASM(Azure Service Manager) API를 사용하는 레거시 Azure 리소스를 관리하기 위한 것입니다. 이 레거시 PowerShell 모듈은 ASM이 사용 중지될 예정이므로 새 리소스를 만들 때 권장되지 않습니다. 자세한 내용은 Azure Service Manager 사용 중지를 참조 하세요.
Az PowerShell 모듈은 PowerShell을 사용하여 ARM(Azure Resource Manager) 리소스를 관리하는 데 권장되는 PowerShell 모듈입니다.
구문
Add-AzureEnvironment
-Name <String>
[-PublishSettingsFileUrl <String>]
[-ServiceEndpoint <String>]
[-ManagementPortalUrl <String>]
[-StorageEndpoint <String>]
[-ActiveDirectoryEndpoint <String>]
[-ResourceManagerEndpoint <String>]
[-GalleryEndpoint <String>]
[-ActiveDirectoryServiceEndpointResourceId <String>]
[-GraphEndpoint <String>]
[-AzureKeyVaultDnsSuffix <String>]
[-AzureKeyVaultServiceEndpointResourceId <String>]
[-TrafficManagerDnsSuffix <String>]
[-SqlDatabaseDnsSuffix <String>]
[-EnableAdfsAuthentication]
[-AdTenant <String>]
[-Profile <AzureSMProfile>]
[<CommonParameters>] Description
Add-AzureEnvironment cmdlet은 새 사용자 지정 Azure 계정 환경을 만들고 로밍 사용자 프로필에 저장합니다. cmdlet은 새 환경을 나타내는 개체를 반환합니다. 명령이 완료되면 Windows PowerShell에서 환경을 사용할 수 있습니다.
Azure 환경은 글로벌 Azure용 AzureCloud 및 중국의 21Vianet에서 운영하는 Azure용 AzureChinaCloud와 같은 Microsoft Azure의 독립적인 배포입니다. Azure 팩 및 WAPack cmdlet을 사용하여 온-프레미스 Azure 환경을 만들 수도 있습니다. 자세한 내용은 Azure 팩을 참조 하세요.
이 cmdlet의 Name 매개 변수만 필수입니다. 매개 변수를 생략하면 해당 값이 null($Null)이고 해당 엔드포인트를 사용하는 서비스가 제대로 작동하지 않을 수 있습니다. 환경 속성의 값을 추가하거나 변경하려면 Set-AzureEnvironment cmdlet을 사용합니다.
참고: 환경을 변경하면 계정이 실패할 수 있습니다. 일반적으로 환경은 테스트 또는 문제 해결을 위해서만 추가됩니다.
이 항목에서는 Microsoft Azure PowerShell 모듈의 0.8.10 버전에 있는 cmdlet에 대해 설명합니다.
사용 중인 모듈의 버전을 얻으려면 Azure PowerShell 콘솔에서 다음을 입력합니다 (Get-Module -Name Azure).Version.
예제
예제 1: Azure 환경 추가
PS C:\> Add-AzureEnvironment -Name ContosoEnv -PublishSettingsFileUrl https://contoso.com/fwlink/?LinkID=101 -ServiceEndpoint https://contoso.com/fwlink/?LinkID=102
Name : ContosoEnv
PublishSettingsFileUrl : https://contoso.com/fwlink/?LinkID=101
ServiceEndpoint : https://contoso.com/fwlink/?LinkID=102
ResourceManagerEndpoint :
ManagementPortalUrl :
ActiveDirectoryEndpoint :
ActiveDirectoryCommonTenantId :
StorageEndpointSuffix :
StorageBlobEndpointFormat :
StorageQueueEndpointFormat :
StorageTableEndpointFormat :
GalleryEndpoint :이 명령은 ContosoEnv Azure 환경을 만듭니다.
매개 변수
-ActiveDirectoryEndpoint
새 환경에서 Microsoft Entra 인증에 대한 엔드포인트를 지정합니다.
| 형식: | String |
| 별칭: | AdEndpointUrl, ActiveDirectory, ActiveDirectoryAuthority |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-ActiveDirectoryServiceEndpointResourceId
액세스가 Microsoft Entra ID로 관리되는 관리 API의 리소스 ID를 지정합니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-AdTenant
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-AzureKeyVaultDnsSuffix
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-AzureKeyVaultServiceEndpointResourceId
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-EnableAdfsAuthentication
| 형식: | SwitchParameter |
| 별칭: | OnPremise |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-GalleryEndpoint
리소스 그룹 갤러리 템플릿을 저장하는 Azure Resource Manager 갤러리의 엔드포인트를 지정합니다. Azure 리소스 그룹 및 갤러리 템플릿에 대한 자세한 내용은 Get-AzureResourceGroupGalleryTemplate에 대한 도움말 항목을 참조하세요.https://go.microsoft.com/fwlink/?LinkID=393052.
| 형식: | String |
| 별칭: | Gallery, GalleryUrl |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-GraphEndpoint
| 형식: | String |
| 별칭: | Graph, GraphUrl |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-ManagementPortalUrl
새 환경에서 Azure 관리 포털의 URL을 지정합니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-Name
환경의 이름을 지정합니다. 이 매개 변수는 필수입니다. 기본 환경인 AzureCloud 및 AzureChinaCloud의 이름을 사용하지 마세요.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-Profile
이 cmdlet이 읽는 Azure 프로필을 지정합니다. 프로필을 지정하지 않으면 이 cmdlet은 로컬 기본 프로필에서 읽습니다.
| 형식: | AzureSMProfile |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-PublishSettingsFileUrl
계정에 대한 게시 설정 파일의 URL을 지정합니다. Azure 게시 설정 파일은 사용자 계정에 대한 정보와 Windows PowerShell이 사용자 대신 Azure 계정에 로그인할 수 있도록 하는 관리 인증서를 포함하는 XML 파일입니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-ResourceManagerEndpoint
계정과 연결된 리소스 그룹에 대한 데이터를 포함하여 Azure Resource Manager 데이터의 엔드포인트를 지정합니다. Azure Resource Manager에 대한 자세한 내용은 Azure Resource Manager Cmdlet() 및 Resource Manager와 https://go.microsoft.com/fwlink/?LinkID=394765함께 Windows PowerShell 사용(https://go.microsoft.com/fwlink/?LinkID=394767)을 참조하세요.
| 형식: | String |
| 별칭: | ResourceManager, ResourceManagerUrl |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-ServiceEndpoint
Azure 서비스 엔드포인트의 URL을 지정합니다. Azure 서비스 엔드포인트는 애플리케이션이 글로벌 Azure 플랫폼, 중국의 21Vianet에서 운영하는 Azure 또는 프라이빗 Azure 설치에서 관리되는지 여부를 결정합니다.
| 형식: | String |
| 별칭: | ServiceManagement, ServiceManagementUrl |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-SqlDatabaseDnsSuffix
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-StorageEndpoint
새 환경에서 스토리지 서비스의 기본 엔드포인트를 지정합니다.
| 형식: | String |
| 별칭: | StorageEndpointSuffix |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-TrafficManagerDnsSuffix
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
입력
None
속성 이름으로 이 cmdlet에 입력을 파이프할 수 있지만 값으로는 파이프할 수 없습니다.
출력
Microsoft.WindowsAzure.Commands.Utilities.Common.WindowsAzureEnvironment