Set-CsRegistrar
마지막으로 수정된 항목: 2012-03-26
하나 이상의 등록자에 대한 속성을 수정하는 데 사용됩니다. 등록자는 로그온 요청을 인증하고 사용자 상태에 대한 정보를 유지 관리하는 데 사용됩니다.
구문
Set-CsRegistrar [-Identity <XdsGlobalRelativeIdentity>] [-ArchivingServer <String>] [-BackupRegistrar <String>] [-Confirm [<SwitchParameter>]] [-EdgeServer <String>] [-EnableAutomaticFailover <$true | $false>] [-FailbackDetectionInterval <TimeSpan>] [-FailureDetectionInterval <TimeSpan>] [-Force <SwitchParameter>] [-MonitoringServer <String>] [-Registrar <String>] [-SipHealthPort <UInt16>] [-SipPort <UInt16>] [-SipServerTcpPort <UInt16>] [-UserServer <String>] [-WebPort <UInt16>] [-WebServer <String>] [-WhatIf [<SwitchParameter>]]
자세한 정보
등록자는 Microsoft Lync Server 2010의 가장 중요한 구성 요소라고 할 수 있습니다. 등록자 없이는 사용자가 시스템에 로그온할 수 없으며 Lync Server 2010에서 사용자와 사용자의 현재 상태를 추적할 수 없기 때문입니다. 사용자가 Lync Server에 로그온하면 로그온한 끝점(컴퓨터, 휴대폰 또는 기타 장치)에서 등록 서버에 REGISTER 요청을 보냅니다. 그러면 서버에서 클라이언트 장치에 인증 자격 증명을 요구하여 응답합니다. 클라이언트가 이 요구를 충족하면, 즉 클라이언트에서 유효한 자격 증명 집합을 제공하면 사용자가 인증되고 IP 주소, 포트 및 사용자 이름과 같은 정보가 등록 데이터베이스에 로깅됩니다. 이 정보는 사용자가 로그오프하면 데이터베이스에서 제거됩니다. 로그온한 시점부터 로그오프할 때까지 등록자는 상태 정보를 최신 상태로 유지하면서 사용자가 주고받는 메시지의 경로 지정을 지원합니다.
Set-CsRegistrar cmdlet을 사용하면 조직에서 사용하는 하나 이상의 등록자에 대한 속성을 수정할 수 있습니다. 예를 들어 포트 설정을 변경하거나 등록자를 사용할 수 없는 경우 수행해야 하는 작업을 지정할 수 있습니다.
이 cmdlet을 실행할 수 있는 사용자: 기본적으로 RTCUniversalServerAdmins 그룹의 구성원은 Set-CsRegistrar cmdlet을 로컬로 실행할 수 있습니다. 사용자가 직접 만든 사용자 지정 RBAC(역할 기반 액세스 제어) 역할을 포함하여 이 cmdlet이 할당된 모든 RBAC 역할의 목록을 가져오려면 Windows PowerShell 프롬프트에서 다음 명령을 실행합니다.
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsRegistrar\b"}
매개 변수
| 매개 변수 | 필수 | 유형 | 설명 |
|---|---|---|---|
Identity |
선택 |
Xds ID |
수정할 등록자의 서비스 위치입니다(예: -Identity "Registrar:atl-cs-001.litwareinc.com"). 이제 등록자를 지정할 때 접두사 "Registrar:"를 남겨 둘 수 있습니다(예: -Identity "atl-cs-001.litwareinc.com"). |
ArchivingServer |
선택 |
문자열 |
등록자와 연결할 보관 서버의 서비스 위치입니다(예: -ArchivingServer "ArchivingServer:atl-cs-001.litwareinc.com"). |
BackupRegistrar |
선택 |
문자열 |
등록자를 사용할 수 없는 경우에 사용할 이 등록자의 서비스 위치입니다(예: -BackupRegistrar "Registrar:dublin-cs-001.litwareinc.com"). |
EdgeServer |
선택 |
문자열 |
등록자와 연결할 에지 서버의 서비스 위치입니다(예: -EdgeServer "EdgeServer:atl-edge-001.litwareinc.com"). |
EnableAutomaticFailover |
선택 |
부울 |
True이면 기본 등록자를 사용할 수 없을 때마다 백업 등록자를 사용하고, False이면 기본 등록자를 사용할 수 없는 경우 백업 등록자를 사용하지 않습니다. 이 매개 변수는 백업 등록자에 등록된 사용자에게도 영향을 줍니다. 이 매개 변수를 True로 설정하면 이러한 사용자는 백업 등록자에서 삭제된 후 기본 등록자를 사용할 수 있을 때 이 등록자에 다시 등록됩니다. |
FailbackDetectionInterval |
선택 |
시간 범위 |
이전에 사용할 수 없던 등록자를 현재 사용할 수 있는지 확인하기 전에 시스템이 대기하게 될 시간을 지정합니다. EnableAutomaticFailover를 True로 설정한 경우 등록자를 사용할 수 없게 될 때마다 시스템이 백업 등록자로 장애 조치(failover)됩니다. 따라서 시스템은 실패한 등록자에 로그온된 사용자를 가져가 백업 등록자에 로그온시킵니다. FailbackDetectionInterval 속성은 시스템이 원래 등록자를 다시 사용할 수 있는지 확인하기 전에 대기하게 될 시간을 지정합니다. 다시 사용할 수 있는 경우 Lync Server가 해당 등록자로 "장애 복구(failback)"를 시도합니다. Failback(장애 복구)은 처음에 사용한 등록자로 다시 전환함을 의미합니다. 즉, 사용자를 다시 원래 등록자에 로그온시킵니다. Failback(장애 복구)은 자동 프로세스로만 수행됩니다. 한 등록자에서 다른 등록자로 수동으로 Failback(장애 복구)을 수행할 수는 없습니다. 검색 간격은 30초에서 84,400초(24시간) 사이의 임의 값으로 설정할 수 있습니다. 시간 간격을 지정할 때는 시간:분:초 형식을 사용합니다. 예를 들어 - FailbackDetectionInterval 01:15:00은 간격을 1시간 15분으로 설정합니다. 백업 등록자를 지정하지 않은 경우에는 이 매개 변수를 사용할 수 없습니다. |
FailureDetectionInterval |
선택 |
시간 범위 |
등록자를 사용할 수 없음을 결정하기 전에 시스템에서 대기할 시간 간격을 지정합니다. EnableAutomaticFailover가 True로 설정된 경우 시스템이 백업 등록자에 대해 사용자 로그온을 시도합니다. 검색 간격은 30초에서 84,400초(24시간) 사이의 임의 값으로 설정할 수 있습니다. 시간 간격을 지정할 때는 시간:분:초 형식을 사용합니다. 예를 들어 - FailureDetectionInterval 01:15:00은 간격을 1시간 15분으로 설정합니다. 백업 등록자를 지정하지 않은 경우에는 이 매개 변수를 사용할 수 없습니다. |
MonitoringServer |
선택 |
문자열 |
등록자와 연결할 모니터링 서버의 서비스 위치입니다(예: -MonitoringServer "MonitoringServer:atl-cs-001.litwareinc.com"). |
Registrar |
선택 |
문자열 |
등록자의 서비스 위치입니다 |
SipPort |
선택 |
정수 |
SIP(Session Initiation Protocol) 트래픽에 사용되는 포트입니다. |
SipHealthPort |
선택 |
문자열 |
서버 상태를 모니터링하는 데 사용되는 포트입니다. |
SipServerTcpPort |
선택 |
문자열 |
SIP 수신 대기 포트입니다. 기본값은 5060입니다. |
UserServer |
선택 |
문자열 |
등록자와 연결할 사용자 서비스 서버의 서비스 위치입니다(예: -UserServer "UserServer:atl-cs-001.litwareinc.com"). |
WebPort |
선택 |
정수 |
웹 서버와 통신하는 데 사용되는 포트입니다. |
WebServer |
선택 |
문자열 |
등록자와 연결할 웹 서버의 서비스 위치입니다(예: -WebServer "WebServer:atl-cs-001.litwareinc.com"). |
Force |
선택 |
스위치 매개 변수 |
명령을 실행할 때 발생할 수 있는 심각하지 않은 오류 메시지를 표시하지 않습니다. |
WhatIf |
선택 |
스위치 매개 변수 |
명령을 실제로 실행하지 않고도 명령이 실행될 경우 발생할 수 있는 현상을 설명합니다. |
Confirm |
선택 |
스위치 매개 변수 |
명령을 실행하기 전에 확인 메시지를 표시합니다. |
입력 형식
없음. Set-CsRegistrar는 파이프라인된 입력을 허용하지 않습니다.
반환 형식
Set-CsRegistrar는 개체나 값을 반환하지 않습니다. 대신 이 명령은 Microsoft.Rtc.Management.Xds.DisplayRegistrar 개체의 기존 인스턴스를 수정합니다.
예제
-------------------------- 예제 1 --------------------------
Set-CsRegistrar -Identity "Registrar:atl-cs-001.litwareinc.com" -SipPort 5072
예제 1에 표시된 명령은 Registrar:atl-cs-001.litwareinc.com 등록자의 SIP 포트를 5072로 설정합니다.
-------------------------- 예제 2 --------------------------
Get-CsService -Registrar | ForEach-Object {Set-CsRegistrar -Identity $_.Identity -SipPort 5072}
위 명령은 조직에서 사용하는 모든 등록자의 SIP 포트를 5072로 설정합니다. 이 작업을 수행하기 위해 명령은 먼저 Get-CsService와 Registrar 매개 변수를 사용하여 현재 사용 중인 모든 등록자 컬렉션을 반환합니다. 이 컬렉션은 컬렉션의 각 등록자를 받고 Set-CsRegistrar cmdlet을 실행하여 SIP 포트를 5072로 변경하는 ForEach-Object cmdlet에 파이프됩니다.
-------------------------- 예제 3 --------------------------
Set-CsRegistrar -Identity "Registrar:atl-cs-001.litwareinc.com" -BackupRegistrar "Registrar:dublin-cs-001.litwareinc.com" -EnableAutomaticFailover $True
예제 3에서는 Registrar:atl-cs-001.litwareinc.com 등록자에 대해 백업 등록자(BackupRegistrar)와 자동 장애 조치(failover)(EnableAutomaticFailover)를 둘 다 구성합니다.