Set-AzureTrafficManagerProfile
Traffic Manager 프로필의 속성을 업데이트합니다.
참고 항목
이 설명서에서 참조되는 cmdlet은 ASM(Azure Service Manager) API를 사용하는 레거시 Azure 리소스를 관리하기 위한 것입니다. 이 레거시 PowerShell 모듈은 ASM이 사용 중지될 예정이므로 새 리소스를 만들 때 권장되지 않습니다. 자세한 내용은 Azure Service Manager 사용 중지를 참조 하세요.
Az PowerShell 모듈은 PowerShell을 사용하여 ARM(Azure Resource Manager) 리소스를 관리하는 데 권장되는 PowerShell 모듈입니다.
구문
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
연결을 분산하는 데 사용할 부하 분산 방법을 지정합니다. 유효한 값은 다음과 같습니다.
- 성능
- 장애 조치(Failover)
- RoundRobin
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-MonitorPort
엔드포인트 상태를 모니터링하는 데 사용되는 포트를 지정합니다. 유효한 값은 0보다 크고 65,535보다 작거나 같은 정수 값입니다.
| 형식: | Int32 |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-MonitorProtocol
엔드포인트 상태를 모니터링 하는 데 사용할 프로토콜을 지정합니다. 유효한 값은 다음과 같습니다.
- Http
- Https
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-MonitorRelativePath
상태를 검색할 엔드포인트 도메인 이름을 기준으로 경로를 지정합니다. 경로는 다음 제한을 충족해야 합니다.
- 경로는 1~1000자여야 합니다.
- 슬래시로 시작해야 합니다.
- XML 요소가 <>없어야 합니다.
- 이중 슬래시를 포함하지 않아야 합니다.
- 잘못된 HTML 이스케이프 문자가 없어야 합니다. 예를 들어 %XY입니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Name
업데이트할 Traffic Manager 프로필의 이름을 지정합니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-Profile
이 cmdlet이 읽는 Azure 프로필을 지정합니다. 프로필을 지정하지 않으면 이 cmdlet은 로컬 기본 프로필에서 읽습니다.
| 형식: | AzureSMProfile |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-TrafficManagerProfile
프로필을 설정하는 데 사용하는 Traffic Manager 프로필 개체를 지정합니다.
| 형식: | IProfileWithDefinition |
| Position: | Named |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-Ttl
로컬 DNS 확인자에게 DNS 항목을 캐시하는 기간을 알려주는 DNS TTL(Time to Live)을 지정합니다. 유효한 값은 30에서 999,999까지의 정수입니다.
| 형식: | Int32 |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
출력
Microsoft.WindowsAzure.Commands.Utilities.TrafficManager.Models.IProfileWithDefinition
이 cmdlet은 Traffic Manager 프로필 개체를 생성합니다.