Set-AzureEnvironment
Azure 환경의 속성을 변경합니다.
참고 항목
이 설명서에서 참조되는 cmdlet은 ASM(Azure Service Manager) API를 사용하는 레거시 Azure 리소스를 관리하기 위한 것입니다. 이 레거시 PowerShell 모듈은 ASM이 사용 중지될 예정이므로 새 리소스를 만들 때 권장되지 않습니다. 자세한 내용은 Azure Service Manager 사용 중지를 참조 하세요.
Az PowerShell 모듈은 PowerShell을 사용하여 ARM(Azure Resource Manager) 리소스를 관리하는 데 권장되는 PowerShell 모듈입니다.
구문
Set-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
Set-AzureEnvironment cmdlet은 Azure 환경의 속성을 변경합니다. 새 속성 값이 있는 환경을 나타내는 개체를 반환합니다. Name 매개 변수를 사용하여 환경 및 다른 매개 변수를 식별하여 속성 값을 변경합니다. Set-AzureEnvironment를 사용하여 Azure 환경의 이름을 변경할 수 없습니다.
Azure 환경은 글로벌 Azure용 AzureCloud 및 중국의 21Vianet에서 운영하는 Azure용 AzureChinaCloud와 같은 Microsoft Azure의 독립적인 배포입니다. Azure 팩 및 WAPack cmdlet을 사용하여 온-프레미스 Azure 환경을 만들 수도 있습니다. 자세한 내용은 Azure 팩을 참조 하세요.
참고: AzureCloud 또는 AzureChinaCloud 환경의 속성을 변경하지 마세요. 이 cmdlet을 사용하여 만드는 프라이빗 환경의 값을 변경합니다.
예제
예제 1: 환경 속성 변경
PS C:\> Set-AzureEnvironment -Name ContosoEnv -PublishSettingsFileUrl "https://contoso.com" -StorageEndpoint "contoso.com"이 명령은 ContosoEnv 환경의 PublishSettingsFileUrl 및 StorageEndpoint 속성 값을 변경합니다.
매개 변수
-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에 대한 도움말 항목을 참조하세요.
| 형식: | 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
변경 중인 환경을 식별합니다. 이 매개 변수는 필수입니다. 매개 변수 값은 대/소문자를 구분합니다. 와일드카드 문자는 허용되지 않습니다.
| 형식: | 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