Add-AzTrafficManagerEndpointConfig

모듈:

Az.TrafficManager

로컬 Traffic Manager 프로필 개체에 엔드포인트를 추가합니다.

구문

Add-AzTrafficManagerEndpointConfig
   -EndpointName <String>
   -TrafficManagerProfile <TrafficManagerProfile>
   -Type <String>
   [-TargetResourceId <String>]
   [-Target <String>]
   -EndpointStatus <String>
   [-Weight <UInt32>]
   [-Priority <UInt32>]
   [-EndpointLocation <String>]
   [-AlwaysServe <String>]
   [-MinChildEndpoints <UInt32>]
   [-MinChildEndpointsIPv4 <UInt32>]
   [-MinChildEndpointsIPv6 <UInt32>]
   [-GeoMapping <System.Collections.Generic.List`1[System.String]>]
   [-SubnetMapping <System.Collections.Generic.List`1[Microsoft.Azure.Commands.TrafficManager.Models.TrafficManagerIpAddressRange]>]
   [-CustomHeader <System.Collections.Generic.List`1[Microsoft.Azure.Commands.TrafficManager.Models.TrafficManagerCustomHeader]>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

Add-AzTrafficManagerEndpointConfig cmdlet은 로컬 Azure Traffic Manager 프로필 개체에 엔드포인트를 추가합니다. New-AzTrafficManagerProfile 또는 Get-AzTrafficManagerProfile cmdlet을 사용하여 프로필을 가져올 수 있습니다.

이 cmdlet은 로컬 프로필 개체에서 작동합니다. Set-AzTrafficManagerProfile cmdlet을 사용하여 Traffic Manager 프로필에 변경 내용을 커밋합니다. 엔드포인트를 만들고 단일 작업에서 변경 내용을 커밋하려면 New-AzTrafficManagerEndpoint cmdlet을 사용합니다.

예제

예제 1: 프로필에 엔드포인트 추가

$TrafficManagerProfile = Get-AzTrafficManagerProfile -Name "ContosoProfile" -ResourceGroupName "ResourceGroup11"
Add-AzTrafficManagerEndpointConfig -EndpointName "contoso" -EndpointStatus Enabled -Target "www.contoso.com" -TrafficManagerProfile $TrafficManagerProfile -Type ExternalEndpoints -EndpointLocation "North Europe" -Priority 1 -Weight 10
Set-AzTrafficManagerProfile -TrafficManagerProfile $TrafficManagerProfile

첫 번째 명령은 Get-AzTrafficManagerProfile cmdlet을 사용하여 Azure Traffic Manager 프로필을 가져옵니다. 이 명령은 로컬 프로필을 $TrafficManagerProfile 변수에 저장합니다.

두 번째 명령은 $TrafficManagerProfile 저장된 프로필에 contoso라는 엔드포인트를 추가합니다. 이 명령에는 엔드포인트에 대한 구성 데이터가 포함됩니다. 이 명령은 로컬 개체만 변경합니다.

최종 명령은 $TrafficManagerProfile 로컬 값과 일치하도록 Azure의 Traffic Manager 프로필을 업데이트합니다.

매개 변수

-AlwaysServe

Always Serve를 사용하도록 설정하면 엔드포인트 상태에 대한 검색이 비활성화되고 엔드포인트가 트래픽 라우팅 방법에 포함됩니다.

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

-CustomHeader

프로브 요청에 대한 사용자 지정 헤더 이름 및 값 쌍의 목록입니다.

형식:	List<T>[TrafficManagerCustomHeader]
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-DefaultProfile

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

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

-EndpointLocation

성능 트래픽 라우팅 메서드에서 사용할 엔드포인트의 위치를 지정합니다. 이 매개 변수는 ExternalEndpoints 또는 NestedEndpoints 유형의 엔드포인트에만 적용됩니다. 성능 트래픽 라우팅 방법을 사용할 때 이 매개 변수를 지정해야 합니다.

Azure 지역 이름을 지정합니다. Azure 지역의 전체 목록은 Azure 지역http://azure.microsoft.com/regions/(http://azure.microsoft.com/regions/)를 참조하세요.

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

-EndpointName

이 cmdlet이 추가하는 Traffic Manager 엔드포인트의 이름을 지정합니다.

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

-EndpointStatus

엔드포인트의 상태를 지정합니다. 유효한 값은 다음과 같습니다.

• 사용
• 비활성화

상태가 사용 상태인 경우 엔드포인트는 엔드포인트 상태에 대해 검색되고 트래픽 라우팅 메서드에 포함됩니다.

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

-GeoMapping

'지리적' 트래픽 라우팅 방법을 사용할 때 이 엔드포인트에 매핑된 지역 목록입니다. 허용되는 값전체 목록은 Traffic Manager 설명서를 참조하세요.

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

-MinChildEndpoints

부모 프로필의 중첩된 엔드포인트를 사용할 수 있는 것으로 간주하려면 자식 프로필에서 사용할 수 있어야 하는 최소 엔드포인트 수입니다. 'NestedEndpoints' 형식의 엔드포인트에만 적용됩니다.

형식:	Nullable<T>[UInt32]
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-MinChildEndpointsIPv4

부모 프로필의 중첩된 엔드포인트를 사용할 수 있는 것으로 간주하려면 자식 프로필에서 사용할 수 있어야 하는 최소 IPv4(DNS 레코드 형식 A) 엔드포인트 수입니다. 'NestedEndpoints' 형식의 엔드포인트에만 적용됩니다.

형식:	Nullable<T>[UInt32]
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-MinChildEndpointsIPv6

부모 프로필의 중첩 엔드포인트를 사용할 수 있는 것으로 간주하려면 자식 프로필에서 사용할 수 있어야 하는 최소 IPv6(DNS 레코드 형식 AAAA) 엔드포인트 수입니다. 'NestedEndpoints' 형식의 엔드포인트에만 적용됩니다.

형식:	Nullable<T>[UInt32]
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Priority

Traffic Manager가 엔드포인트에 할당하는 우선 순위를 지정합니다. 이 매개 변수는 Traffic Manager 프로필이 for Priority 트래픽 라우팅 방법으로 구성된 경우에만 사용됩니다. 유효한 값은 1에서 1000까지의 정수입니다. 값이 낮을수록 높은 우선 순위를 나타냅니다.

우선 순위를 지정하는 경우 프로필의 모든 엔드포인트에서 우선 순위를 지정해야 하며 두 엔드포인트가 동일한 우선 순위 값을 공유할 수 없습니다. 우선 순위를 지정하지 않으면 Traffic Manager는 프로필이 엔드포인트를 나열하는 순서대로 1부터 시작하여 엔드포인트에 기본 우선 순위 값을 할당합니다.

형식:	Nullable<T>[UInt32]
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-SubnetMapping

'서브넷' 트래픽 라우팅 방법을 사용할 때 이 엔드포인트에 매핑된 주소 범위 또는 서브넷 목록입니다.

형식:	List<T>[TrafficManagerIpAddressRange]
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Target

엔드포인트의 정규화된 DNS 이름을 지정합니다. Traffic Manager는 트래픽을 이 엔드포인트로 보낼 때 DNS 응답에서 이 값을 반환합니다. ExternalEndpoints 엔드포인트 유형에 대해서만 이 매개 변수를 지정합니다. 다른 엔드포인트 형식의 경우 TargetResourceId 매개 변수를 대신 지정합니다.

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

-TargetResourceId

대상의 리소스 ID를 지정합니다. AzureEndpoints 및 NestedEndpoints 엔드포인트 유형에 대해서만 이 매개 변수를 지정합니다. ExternalEndpoints 엔드포인트 형식의 경우 Target 매개 변수를 대신 지정합니다.

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

-TrafficManagerProfile

로컬 TrafficManagerProfile 개체를 지정합니다. 이 cmdlet은 이 로컬 개체를 수정합니다. TrafficManagerProfile 개체를 가져오려면 Get-AzTrafficManagerProfile cmdlet을 사용합니다.

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

-Type

이 cmdlet이 Azure Traffic Manager 프로필에 추가하는 엔드포인트 유형을 지정합니다. 유효한 값은 다음과 같습니다.

• AzureEndpoints
• ExternalEndpoints
• NestedEndpoints

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

-Weight

Traffic Manager가 엔드포인트에 할당하는 가중치를 지정합니다. 유효한 값은 1에서 1000까지의 정수입니다. 기본값은 1입니다. 이 매개 변수는 Traffic Manager 프로필이 가중 트래픽 라우팅 방법으로 구성된 경우에만 사용됩니다.

형식:	Nullable<T>[UInt32]
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

입력

TrafficManagerProfile

출력

TrafficManagerProfile

관련 링크

• Get-AzTrafficManagerProfile
• New-AzTrafficManagerEndpoint
• Remove-AzTrafficManagerEndpointConfig
• Set-AzTrafficManagerProfile