다음을 통해 공유

Set-AzureTrafficManagerProfile

  • 참조
모듈:
Azure

Traffic Manager 프로필의 속성을 업데이트합니다.

참고

이 설명서에서 참조하는 cmdlet은 Service Management API를 사용하는 레거시 Azure 리소스를 관리하기 위한 것입니다. Azure Resource Manager 리소스를 관리하는 cmdlet은 Az PowerShell 모듈을 참조하세요.

Syntax

Set-AzureTrafficManagerProfile
   [-Name <String>]
   [-LoadBalancingMethod <String>]
   [-MonitorPort <Int32>]
   [-MonitorProtocol <String>]
   [-MonitorRelativePath <String>]
   [-Ttl <Int32>]
   -TrafficManagerProfile <IProfileWithDefinition>
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]

Description

Set-AzureTrafficManagerProfile cmdlet은 Microsoft Azure Traffic Manager 프로필의 속성을 업데이트합니다.

LoadBalancingMethod 값을 "장애 조치(failover)"로 설정한 프로필의 경우 Add-AzureTrafficManagerEndpoint cmdlet을 사용하여 프로필에 추가한 엔드포인트의 장애 조치 순서를 확인할 수 있습니다. 자세한 내용은 아래 예제 3을 참조하세요.

예제

예제 1: Traffic Manager 프로필에 대한 TTL 설정

PS C:\>Set-AzureTrafficManagerProfile -TrafficManagerProfile $MyTrafficManagerProfile -Ttl 60

이 명령은 Traffic Manager 프로필 개체 MyTrafficManagerProfile에 대해 TTL을 60초로 설정합니다.

예제 2: 프로필에 대한 여러 값 설정

PS C:\>Get-AzureTrafficManagerProfile -Name "MyProfile" | Set-AzureTrafficManagerProfile -LoadBalancingMethod "RoundRobin" -Ttl 30 -MonitorProtocol "Http" -MonitorPort 80 -MonitorRelativePath "/"

이 명령은 Get-AzureTrafficManagerProfile cmdlet을 사용하여 MyProfile 이라는 Traffic Manager 프로필을 가져옵니다. 프로필은 RoundRobin 부하 분산 방법, 30초의 TTL, 모니터 프로토콜 HTTP, 모니터 포트 및 Traffic Manager 프로필의 상대 경로를 사용합니다.

예제 3: 엔드포인트를 원하는 장애 조치 순서로 순서 변경

PS C:\>$Profile = Get-AzureTrafficManagerProfile -Name "MyProfile"
PS C:\> $Profile.Endpoints[0],$Profile.Endpoints[1] = $Profile.Endpoints[1],$Profile.Endpoints[0]
PS C:\> $Profile = Set-AzureTrafficManagerProfile

다음은 MyProfile에 추가된 엔드포인트를 원하는 장애 조치 순서로 다시 정렬하는 예제입니다.

첫 번째 명령은 MyProfile이라는 Traffic Manager 프로필 개체를 가져오고 개체를 $Profile 변수에 저장합니다.

두 번째 명령은 엔드포인트 배열에서 장애 조치(failover)가 수행되어야 하는 순서로 엔드포인트의 순서를 다시 지정합니다.

마지막 명령은 $Profile 저장된 Traffic Manager 프로필을 새 엔드포인트 순서로 업데이트합니다.

매개 변수

-LoadBalancingMethod

연결을 분산하는 데 사용할 부하 분산 방법을 지정합니다. 유효한 값은 다음과 같습니다.

  • 성능
  • 장애 조치
  • RoundRobin
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MonitorPort

엔드포인트 상태를 모니터링하는 데 사용되는 포트를 지정합니다. 유효한 값은 0보다 크고 65,535보다 작거나 같은 정수 값입니다.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MonitorProtocol

엔드포인트 상태를 모니터링하는 데 사용할 프로토콜을 지정합니다. 유효한 값은 다음과 같습니다.

  • Http
  • Https
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MonitorRelativePath

상태를 검색할 엔드포인트 도메인 이름을 기준으로 경로를 지정합니다. 경로는 다음 제한을 충족해야 합니다.

  • 경로는 1~1000자여야 합니다.
  • 슬래시로 시작해야 합니다.
  • XML 요소가 <>없어야 합니다.
  • 이중 슬래시를 포함하지 않아야 합니다.
  • 잘못된 HTML 이스케이프 문자가 없어야 합니다. 예를 들어 %XY입니다.
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

업데이트할 Traffic Manager 프로필의 이름을 지정합니다.

Type:String
Position:Named
Default value:None
Required:False
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

-TrafficManagerProfile

프로필을 설정하는 데 사용하는 Traffic Manager 프로필 개체를 지정합니다.

Type:IProfileWithDefinition
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Ttl

로컬 DNS 확인자에게 DNS 항목을 캐시하는 기간을 알려주는 DNS TTL(Time to Live)을 지정합니다. 유효한 값은 30에서 999,999까지의 정수입니다.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

출력

Microsoft.WindowsAzure.Commands.Utilities.TrafficManager.Models.IProfileWithDefinition

이 cmdlet은 Traffic Manager 프로필 개체를 생성합니다.