다음을 통해 공유


Set-AzEnvironment

Azure 환경에 대한 속성을 설정합니다.

구문

Set-AzEnvironment
   [-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>]
   [[-AzureDataLakeStoreFileSystemEndpointSuffix] <String>]
   [[-AzureDataLakeAnalyticsCatalogAndJobEndpointSuffix] <String>]
   [-EnableAdfsAuthentication]
   [[-AdTenant] <String>]
   [[-GraphAudience] <String>]
   [[-DataLakeAudience] <String>]
   [[-BatchEndpointResourceId] <String>]
   [[-AzureOperationalInsightsEndpointResourceId] <String>]
   [[-AzureOperationalInsightsEndpoint] <String>]
   [-AzureAnalysisServicesEndpointSuffix <String>]
   [-AzureAnalysisServicesEndpointResourceId <String>]
   [-AzureAttestationServiceEndpointSuffix <String>]
   [-AzureAttestationServiceEndpointResourceId <String>]
   [-AzureSynapseAnalyticsEndpointSuffix <String>]
   [-ContainerRegistryEndpointSuffix <String>]
   [-AzureSynapseAnalyticsEndpointResourceId <String>]
   [-MicrosoftGraphEndpointResourceId <String>]
   [-MicrosoftGraphUrl <String>]
   [-Scope <ContextModificationScope>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzEnvironment
   [-Name] <String>
   [[-StorageEndpoint] <String>]
   [-ARMEndpoint] <String>
   [[-AzureKeyVaultDnsSuffix] <String>]
   [[-AzureKeyVaultServiceEndpointResourceId] <String>]
   [[-DataLakeAudience] <String>]
   [[-BatchEndpointResourceId] <String>]
   [[-AzureOperationalInsightsEndpointResourceId] <String>]
   [[-AzureOperationalInsightsEndpoint] <String>]
   [-AzureAnalysisServicesEndpointSuffix <String>]
   [-AzureAnalysisServicesEndpointResourceId <String>]
   [-AzureAttestationServiceEndpointSuffix <String>]
   [-AzureAttestationServiceEndpointResourceId <String>]
   [-AzureSynapseAnalyticsEndpointSuffix <String>]
   [-ContainerRegistryEndpointSuffix <String>]
   [-AzureSynapseAnalyticsEndpointResourceId <String>]
   [-Scope <ContextModificationScope>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Set-AzEnvironment cmdlet은 Azure 인스턴스에 연결하기 위한 엔드포인트 및 메타데이터를 설정합니다.

예제

예제 1: 새 환경 만들기 및 수정

Add-AzEnvironment -Name TestEnvironment `
        -ActiveDirectoryEndpoint TestADEndpoint `
        -ActiveDirectoryServiceEndpointResourceId TestADApplicationId `
        -ResourceManagerEndpoint TestRMEndpoint `
        -GalleryEndpoint TestGalleryEndpoint `
        -GraphEndpoint TestGraphEndpoint

Name            Resource Manager Url ActiveDirectory Authority
----            -------------------- -------------------------
TestEnvironment TestRMEndpoint       TestADEndpoint/

Set-AzEnvironment -Name TestEnvironment `
        -ActiveDirectoryEndpoint NewTestADEndpoint `
        -GraphEndpoint NewTestGraphEndpoint | Format-List

Name                                              : TestEnvironment
EnableAdfsAuthentication                          : False
ActiveDirectoryServiceEndpointResourceId          : TestADApplicationId
AdTenant                                          :
GalleryUrl                                        : TestGalleryEndpoint
ManagementPortalUrl                               :
ServiceManagementUrl                              : 
PublishSettingsFileUrl                            :
ResourceManagerUrl                                : TestRMEndpoint
SqlDatabaseDnsSuffix                              :
StorageEndpointSuffix                             :
ActiveDirectoryAuthority                          : NewTestADEndpoint
GraphUrl                                          : NewTestGraphEndpoint
GraphEndpointResourceId                           :
TrafficManagerDnsSuffix                           :
AzureKeyVaultDnsSuffix                            :
AzureDataLakeStoreFileSystemEndpointSuffix        :
AzureDataLakeAnalyticsCatalogAndJobEndpointSuffix :
AzureKeyVaultServiceEndpointResourceId            :
BatchEndpointResourceId                           :
AzureOperationalInsightsEndpoint                  :
AzureOperationalInsightsEndpointResourceId        :
AzureAttestationServiceEndpointSuffix             :
AzureAttestationServiceEndpointResourceId         :
AzureSynapseAnalyticsEndpointSuffix               :
AzureSynapseAnalyticsEndpointResourceId           :

이 예제에서는 Add-AzEnvironment를 사용하여 샘플 엔드포인트를 사용하여 새 Azure 환경을 만든 다음, cmdlet Set-AzEnvironment를 사용하여 만든 환경의 ActiveDirectoryEndpoint 및 GraphEndpoint 특성 값을 변경합니다.

매개 변수

-ActiveDirectoryEndpoint

Azure Active Directory 인증에 대한 기본 기관을 지정합니다.

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

-ActiveDirectoryServiceEndpointResourceId

Azure Resource Manager 또는 RDFE(서비스 관리) 엔드포인트에 대한 요청을 인증하는 토큰의 대상 그룹을 지정합니다.

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

-AdTenant

기본 Active Directory 테넌트 지정

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

-ARMEndpoint

Azure Resource Manager 엔드포인트입니다.

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

-AzureAnalysisServicesEndpointResourceId

Azure Analysis Services 리소스의 리소스 식별자입니다.

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

-AzureAnalysisServicesEndpointSuffix

Azure Log Analytics API와 통신할 때 사용할 엔드포인트입니다.

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

-AzureAttestationServiceEndpointResourceId

요청된 토큰의 수신자인 Azure Attestation 서비스의 리소스 식별자입니다.

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

-AzureAttestationServiceEndpointSuffix

Azure Attestation 서비스의 Dns 접미사입니다.

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

-AzureDataLakeAnalyticsCatalogAndJobEndpointSuffix

Azure Data Lake Analytics 작업 및 카탈로그 서비스의 Dns 접미사

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

-AzureDataLakeStoreFileSystemEndpointSuffix

Azure Data Lake Store FileSystem의 Dns 접미사입니다. 예: azuredatalake.net

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

-AzureKeyVaultDnsSuffix

Azure Key Vault 서비스의 Dns 접미사입니다. 예제는 vault-int.azure-int.net

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

-AzureKeyVaultServiceEndpointResourceId

요청된 토큰의 수신자인 Azure Key Vault 데이터 서비스의 리소스 식별자입니다.

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

-AzureOperationalInsightsEndpoint

Azure Log Analytics API와 통신할 때 사용할 엔드포인트입니다.

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

-AzureOperationalInsightsEndpointResourceId

Azure Log Analytics API를 사용하여 인증하는 토큰의 대상 그룹입니다.

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

-AzureSynapseAnalyticsEndpointResourceId

요청된 토큰의 수신자인 Azure Synapse Analytics의 리소스 식별자입니다.

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

-AzureSynapseAnalyticsEndpointSuffix

Azure Synapse Analytics의 Dns 접미사입니다.

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

-BatchEndpointResourceId

요청된 토큰의 수신자인 Azure Batch 서비스의 리소스 식별자입니다.

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

-Confirm

cmdlet을 실행하기 전에 확인 메시지가 표시됩니다.

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

-ContainerRegistryEndpointSuffix

Azure Container Registry의 접미사입니다.

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

-DataLakeAudience

AD Data Lake 서비스 엔드포인트를 사용하여 인증하는 토큰의 대상 그룹입니다.

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

-DefaultProfile

Azure와의 통신에 사용되는 자격 증명, 계정, 테넌트 및 구독입니다.

형식:IAzureContextContainer
별칭:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-EnableAdfsAuthentication

ADFS(Active Directory Federation Services) 온-프레미스 인증이 허용됨을 나타냅니다.

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

-GalleryEndpoint

배포 템플릿의 Azure Resource Manager 갤러리에 대한 엔드포인트를 지정합니다. 매개 변수는 값을 .의 PSAzureEnvironment값으로 설정하는 것입니다GalleryUrl. ArmMetadata에서 제거되었으므로 GalleryUrl Azure PowerShell은 더 이상 값을 제공하지 않으므로 더 이상 설정 GalleryEndpoint 하지 않는 것이 좋습니다.

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

-GraphAudience

AD Graph 엔드포인트를 사용하여 인증하는 토큰의 대상 그룹입니다.

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

-GraphEndpoint

Graph(Active Directory 메타데이터) 요청의 URL을 지정합니다.

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

-ManagementPortalUrl

관리 포털의 URL을 지정합니다.

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

-MicrosoftGraphEndpointResourceId

Microsoft Graph의 리소스 식별자

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

-MicrosoftGraphUrl

Microsoft Graph Url

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

-Name

수정할 환경의 이름을 지정합니다.

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

-PublishSettingsFileUrl

.publishsettings 파일을 다운로드할 수 있는 URL을 지정합니다.

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

-ResourceManagerEndpoint

Azure Resource Manager 요청에 대한 URL을 지정합니다.

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

-Scope

예를 들어 변경 내용이 현재 프로세스에만 적용되는지 아니면 이 사용자가 시작한 모든 세션에만 적용되는지와 같은 컨텍스트 변경 범위를 결정합니다.

형식:ContextModificationScope
허용되는 값:Process, CurrentUser
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ServiceEndpoint

RDFE(서비스 관리) 요청에 대한 엔드포인트를 지정합니다.

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

-SqlDatabaseDnsSuffix

Azure SQL Database 서버의 도메인 이름 접미사를 지정합니다.

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

-StorageEndpoint

스토리지(Blob, 테이블, 큐 및 파일) 액세스에 대한 엔드포인트를 지정합니다.

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

-TrafficManagerDnsSuffix

Azure Traffic Manager 서비스의 도메인 이름 접미사를 지정합니다.

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

-WhatIf

cmdlet이 실행될 경우 결과 동작을 표시합니다. cmdlet이 실행되지 않습니다.

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

입력

String

SwitchParameter

출력

PSAzureEnvironment