Set-CsDirector
마지막으로 수정된 항목: 2012-03-27
하나 이상의 디렉터 속성을 수정합니다. 사용자 요청을 인증하기 위해 디렉터를 사용할 수 있지만, 디렉터는 사용자 계정을 호스트하지 않습니다.
구문
Set-CsDirector [-Identity <XdsGlobalRelativeIdentity>] [-ArchivingServer <String>] [-Confirm [<SwitchParameter>]] [-EdgeServer <String>] [-Force <SwitchParameter>] [-MonitoringServer <String>] [-SipHealthPort <UInt16>] [-SipPort <UInt16>] [-SipServerTcpPort <UInt16>] [-WebPort <UInt16>] [-WebServer <String>] [-WhatIf [<SwitchParameter>]]
자세한 정보
디렉터는 사용자 계정을 실제로 호스팅하지 않으면서 사용자를 인증하고 사용자 요청에 응답합니다. 일반적으로 디렉터는 에지 서버를 통해 네트워크에 대한 외부 액세스를 허용하는 조직에 사용됩니다. 이 시나리오에서 디렉터는 인증 요청을 처리하여 프런트 엔드 서버에 대한 긴장을 완화할 뿐만 아니라 서비스 거부 공격과 다른 악의적인 트래픽으로부터 내부 네트워크를 보호할 수 있습니다. 디렉터는 여러 프런트 엔드 서버가 중앙 사이트에 배포된 경우에도 유용합니다. 이 경우 디렉터는 모든 사용자 요청을 수신한 다음 해당 요청을 적절한 서버 풀로 보냅니다. 이 작업을 통해 프런트 엔드 서버에 대한 부담이 완화될 수 있습니다.
Set-CsDirector cmdlet을 사용하면 조직에서 현재 사용되고 있는 디렉터의 속성 값을 수정할 수 있습니다. 이 작업에는 디렉터와 연결된 보관 서버 또는 에지 서버 등의 변경이나 SIP 트래픽을 보내고 받는 데 사용되는 포트 변경이 포함됩니다.
이 cmdlet을 실행할 수 있는 사용자: 기본적으로 RTCUniversalServerAdmins 그룹의 구성원은 Set-CsDirector cmdlet을 로컬로 실행할 수 있습니다. 사용자가 직접 만든 사용자 지정 RBAC(역할 기반 액세스 제어) 역할을 포함하여 이 cmdlet이 할당된 모든 RBAC 역할의 목록을 가져오려면 Windows PowerShell 프롬프트에서 다음 명령을 실행합니다.
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsDirector"}
매개 변수
| 매개 변수 | 필수 | 유형 | 설명 |
|---|---|---|---|
Identity |
선택 |
Xds ID |
수정할 디렉터의 서비스 위치입니다(예: -Identity "Director:atl-cs-001.litwareinc.com"). 디렉터를 지정할 때 접두사 "Director:"를 생략할 수 있습니다(예: -Identity "atl-cs-001.litwareinc.com"). |
ArchivingServer |
선택 |
문자열 |
디렉터와 연결할 보관 서버의 서비스 위치입니다(예: -ArchivingServer "ArchivingServer:atl-cs-001.litwareinc.com"). |
EdgeServer |
선택 |
문자열 |
디렉터와 연결할 에지 서버의 서비스 위치입니다(예: -EdgeServer "EdgeServer:atl-edge-001.litwareinc.com"). |
MonitoringServer |
선택 |
문자열 |
디렉터와 연결할 모니터링 서버의 서비스 위치입니다(예: -MonitoringServer "MonitoringServer:atl-cs-001.litwareinc.com"). |
SipPort |
선택 |
정수 |
SIP(Session Initiation Protocol) 트래픽에 사용되는 포트입니다. |
SipHealthPort |
선택 |
정수 |
서버 상태를 모니터링하는 데 사용되는 포트입니다. |
SipServerTcpPort |
선택 |
정수 |
SIP 수신 대기 포트입니다. 기본값은 5060입니다. |
WebPort |
선택 |
정수 |
웹 서비스와 통신하는 데 사용되는 포트입니다. |
WebServer |
선택 |
문자열 |
디렉터와 연결할 서버의 웹 서비스 위치입니다(예: -WebServer "WebServer:atl-cs-001.litwareinc.com"). |
Force |
선택 |
스위치 매개 변수 |
명령을 실행할 때 발생할 수 있는 심각하지 않은 오류 메시지를 표시하지 않습니다. |
WhatIf |
선택 |
스위치 매개 변수 |
명령을 실제로 실행하지 않고도 명령이 실행될 경우 발생할 수 있는 현상을 설명합니다. |
Confirm |
선택 |
스위치 매개 변수 |
명령을 실행하기 전에 확인 메시지를 표시합니다. |
입력 형식
없음. Set-CsDirector는 파이프라인된 입력을 허용하지 않습니다.
반환 형식
Set-CsDirector는 값이나 개체를 반환하지 않습니다. 대신 이 cmdlet은 Microsoft.Rtc.Management.Xds.DisplayDirector 개체의 기존 인스턴스를 수정합니다.
예제
-------------------------- 예제 1 ------------------------
Set-CsDirector -Identity "Director:atl-cs-001.litwareinc.com" -ArchivingServer "ArchivingServer:dublin-cs-001.litwareinc.com"
예제 1에 표시된 명령은 디렉터 Director:atl-cs-001.litwareinc.com과 연결된 보관 서버를 변경합니다. 이 예제에서는 보관 서버를 ArchivingServer:dublin-cs-001.litwareinc.com으로 전환합니다.
-------------------------- 예제 2 ------------------------
Get-CsService -Director | ForEach-Object {Set-CsDirector -Identity $_.Identity -SipPort 5072}
위 명령은 조직에서 현재 사용되고 있는 모든 디렉터의 SIP 포트를 변경합니다. 이를 위해 먼저 Get-CsService와 Director 매개 변수를 사용하여 조직에 있는 모든 디렉터의 컬렉션을 반환합니다. 이 컬렉션은 ForEach-Object cmdlet에 파이프됩니다. ForEach-Object는 컬렉션의 각 사이트에 대해 Set-CsDirector를 실행하여 SipPort 속성 값을 5072로 변경합니다.