Set-AzureEnvironment
Azure 환경의 속성을 변경합니다.
참고 항목
이 설명서에서 참조하는 cmdlet은 Service Management API를 사용하는 레거시 Azure 리소스를 관리하기 위한 것입니다. Azure Resource Manager 리소스를 관리하는 cmdlet은 Az PowerShell 모듈을 참조하세요.
Syntax
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 환경의 Publish설정FileUrl 및 StorageEndpoint 속성 값을 변경합니다.
매개 변수
-ActiveDirectoryEndpoint
Microsoft Entra 인증의 엔드포인트를 지정된 값으로 변경합니다.
| Type: | String |
| Aliases: | AdEndpointUrl, ActiveDirectory, ActiveDirectoryAuthority |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ActiveDirectoryServiceEndpointResourceId
액세스가 Microsoft Entra ID로 관리되는 관리 API의 리소스 ID를 지정합니다.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-AdTenant
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-AzureKeyVaultDnsSuffix
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-AzureKeyVaultServiceEndpointResourceId
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-EnableAdfsAuthentication
| Type: | SwitchParameter |
| Aliases: | OnPremise |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-GalleryEndpoint
Azure Resource Manager 갤러리의 엔드포인트를 지정된 값으로 변경합니다. 갤러리 엔드포인트는 리소스 그룹 갤러리 템플릿의 위치입니다. Azure 리소스 그룹 및 갤러리 템플릿에 대한 자세한 내용은 Get-AzureResourceGroupGalleryTemplate에 대한 도움말 항목을 참조하세요.
| Type: | String |
| Aliases: | Gallery, GalleryUrl |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-GraphEndpoint
| Type: | String |
| Aliases: | Graph, GraphUrl |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ManagementPortalUrl
Azure 관리 포털의 URL을 지정된 값으로 변경합니다.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Name
변경 중인 환경을 식별합니다. 이 매개 변수는 필수입니다. 매개 변수 값은 대/소문자를 구분합니다. 와일드카드 문자는 허용되지 않습니다.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| 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 |
-PublishSettingsFileUrl
지정된 환경에서 게시 설정 파일의 URL을 변경합니다. Azure 게시 설정 파일은 사용자 계정에 대한 정보와 Windows PowerShell이 사용자 대신 Azure 계정에 로그인할 수 있도록 하는 관리 인증서를 포함하는 XML 파일입니다.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | 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)을 참조하세요.
| Type: | String |
| Aliases: | ResourceManager, ResourceManagerUrl |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ServiceEndpoint
지정된 환경에서 Azure 서비스 엔드포인트의 URL을 변경합니다. Azure 서비스 엔드포인트는 애플리케이션이 글로벌 Azure 플랫폼, 중국의 21Vianet에서 운영하는 Azure 또는 프라이빗 Azure 설치에서 관리되는지 여부를 결정합니다.
| Type: | String |
| Aliases: | ServiceManagement, ServiceManagementUrl |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-SqlDatabaseDnsSuffix
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-StorageEndpoint
지정된 환경에서 스토리지 서비스의 기본 엔드포인트를 변경합니다.
| Type: | String |
| Aliases: | StorageEndpointSuffix |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TrafficManagerDnsSuffix
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
입력
None
속성 이름으로 이 cmdlet에 입력을 파이프할 수 있지만 값으로는 파이프할 수 없습니다.
출력
Microsoft.WindowsAzure.Commands.Utilities.Common.WindowsAzureEnvironment