New-CsRegistrarConfiguration
마지막으로 수정된 항목: 2012-03-25
새 등록자 구성 설정 컬렉션을 만듭니다. 등록자는 로그온 요청을 인증하고 사용자 상태에 대한 정보를 유지 관리하는 데 사용됩니다.
구문
New-CsRegistrarConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-DefaultEndpointExpiration <Int32>] [-EnableDHCPServer <$true | $false>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-MaxEndpointExpiration <Int32>] [-MaxEndpointsPerUser <UInt16>] [-MinEndpointExpiration <Int32>] [-WhatIf [<SwitchParameter>]]
자세한 정보
등록자는 Lync Server의 가장 중요한 구성 요소라고 할 수 있습니다. 등록자 없이는 사용자가 시스템에 로그온할 수 없으며 Lync Server에서 사용자와 사용자의 현재 상태를 추적할 수 없기 때문입니다. 사용자가 Lync Server에 로그온하면 로그온한 끝점에서 등록자에 REGISTER 요청을 보냅니다. 그러면 서버에서 클라이언트 장치의 인증 자격 증명을 요구하여 응답합니다. 클라이언트가 응답을 전달하는 경우(클라이언트가 유효한 자격 증명 집합을 제공하는 경우) 사용자가 인증되고 IP 주소, 포트 및 사용자 이름과 같은 끝점 정보가 등록 데이터베이스에 로깅됩니다. 사용자가 로그오프하면 이 정보가 데이터베이스에서 제거됩니다. 로그온한 시점부터 로그오프할 때까지 등록자는 상태 정보를 최신 상태로 유지하면서 사용자가 주고받는 메시지의 경로 지정을 지원합니다.
등록자 구성 설정은 끝점과 끝점 구독을 관리하는 데 사용됩니다. 이러한 설정은 전역, 사이트 또는 서비스 범위에서 적용할 수 있습니다. 서비스 범위 설정은 등록자 서비스에서만 사용할 수 있습니다.
New-CsRegistrarConfiguration cmdlet을 사용하면 사이트 또는 서비스 범위에서 새 등록자 구성 설정을 만들 수 있습니다. 지정된 사이트 또는 서비스에는 이러한 설정 컬렉션이 최대 한 개만 포함될 수 있습니다. 등록자 구성 설정 컬렉션이 이미 호스트되어 있는 사이트나 서비스에 새 컬렉션을 추가하려고 하면 명령이 실패합니다. 글로벌 범위에서 새 설정을 만들려고 하는 경우에도 명령이 실패합니다.
이 cmdlet을 실행할 수 있는 사용자: 기본적으로 RTCUniversalServerAdmins 그룹의 구성원은 New-CsRegistrarConfiguration cmdlet을 로컬로 실행할 수 있습니다. 사용자가 직접 만든 사용자 지정 RBAC(역할 기반 액세스 제어) 역할을 포함하여 이 cmdlet이 할당된 모든 RBAC 역할의 목록을 가져오려면 Windows PowerShell 프롬프트에서 다음 명령을 실행합니다.
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsRegistrarConfiguration"}
매개 변수
| 매개 변수 | 필수 | 유형 | 설명 |
|---|---|---|---|
Identity |
선택 |
Xds ID |
만들려는 등록자 구성 설정의 고유 식별자입니다. 사이트 범위에서 구성된 설정을 만들려면 -Identity site:Redmond와 유사한 구문을 사용합니다. 서비스 수준에서 설정을 만들려면 -Identity service:Registrar:atl-cs-001.litwareinc.com과 유사한 구문을 사용합니다. 지정된 사이트 또는 서비스에는 등록자 설정 컬렉션이 최대 한 개만 포함될 수 있습니다. Identity가 site:Redmond인 새 컬렉션을 만들려고 하는데 Redmond 사이트에 등록자 설정 컬렉션이 이미 호스팅되어 있으면 명령이 실패합니다. 또한 글로벌 범위에서는 새 등록자 설정을 만들 수 없습니다. 글로벌 범위에서 값을 변경하려면 Set-CsRegistrarConfiguration cmdlet을 사용합니다. |
DefaultEndpointExpiration |
선택 |
정수 |
끝점은 로그온 시 만료 시간 제한을 요청할 수 있습니다. 이 옵션은 끝점이 서버에 연결하고 연장을 요청하기 전에 시스템에 로그온된 상태로 유지될 수 있는 시간 간격을 지정합니다. DefaultEndpointExpiration 속성은 특정 시간 제한 값을 요청하지 않는 클라이언트의 만료 시간 제한 간격을 나타냅니다. DefaultEndpointExpiration은 300(5분)에서 900(15분) 사이여야 합니다. 기본값은 600(10분)입니다. |
EnableDHCPServer |
선택 |
부울 |
끝점에서 DHCP 서버를 사용하여 등록자를 찾을 수 있는지 여부를 나타냅니다. True일 경우 클라이언트가 처음 시작할 때 DHCP 알림 메시지를 보내고, DHCP 서버가 사용자를 로그온시키는 데 사용할 수 있는 등록자의 FQDN(정규화된 도메인 이름)을 보내 응답합니다. |
MaxEndpointExpiration |
선택 |
정수 |
끝점이 로그온하면 만료 시간 제한을 요청할 수 있습니다. 이는 끝점이 서버에 연결하여 연장을 요청하기 전까지 시스템에 로그온 상태로 있을 수 있는 시간 간격을 지정합니다. MaxEndpointExpiration 속성은 클라이언트에 부여할 수 있는 최대 시간을 나타냅니다. 예를 들어 최대 시간이 600초로 설정되고 클라이언트가 시간 제한 간격으로 800초를 요청하는 경우 클라이언트에 제공되는 최대 허용 만료 기간은 600초입니다. MaxEndpointExpiration은 300(5분)에서 900(15분) 사이여야 합니다. 기본값은 900입니다. |
MinEndpointExpiration |
선택 |
정수 |
끝점이 로그온하면 만료 시간 제한을 요청할 수 있습니다. 이는 끝점이 서버에 연결하여 연장을 요청하기 전까지 시스템에 로그온 상태로 있을 수 있는 시간 간격을 지정합니다. MinEndpointExpiration 속성은 클라이언트에 부여할 수 있는 최소 시간을 나타냅니다. 예를 들어 최소 시간이 600초로 설정되고 클라이언트가 시간 제한 간격으로 200초를 요청하는 경우 클라이언트에 제공되는 최소 허용 만료 기간은 600초입니다. MinEndpointExpiration은 300(5분)에서 900(15분) 사이여야 합니다. 기본값은 300입니다. |
MaxEndpointsPerUser |
선택 |
정수 |
사용자가 동시에 시스템에 연결할 수 있는 최대 끝점 수를 나타냅니다. 예를 들어 컴퓨터와 휴대폰을 동시에 사용하여 Lync Server 2010에 로그온한 사용자는 2개의 끝점을 사용하는 것입니다. MaxEndpointsPerUser는 1-64(포함) 사이의 값으로 설정해야 합니다. 기본값은 8입니다. |
Force |
선택 |
스위치 매개 변수 |
명령을 실행할 때 발생할 수 있는 심각하지 않은 오류 메시지를 표시하지 않습니다. |
InMemory |
선택 |
스위치 매개 변수 |
개체를 실제로 영구 변경 사항으로 커밋하지 않고 개체 참조를 만듭니다. 이 매개 변수와 함께 호출된 이 cmdlet의 결과를 변수로 할당하면 개체 참조의 속성을 변경한 후 이 cmdlet과 일치하는 Set- cmdlet을 호출하여 해당 변경 사항을 커밋할 수 있습니다. |
WhatIf |
선택 |
스위치 매개 변수 |
명령을 실제로 실행하지 않고도 명령이 실행될 경우 발생할 수 있는 현상을 설명합니다. |
Confirm |
선택 |
스위치 매개 변수 |
명령을 실행하기 전에 확인 메시지를 표시합니다. |
입력 형식
없음. New-CsRegistrarConfiguration은 파이프라인된 입력을 허용하지 않습니다.
반환 형식
New-CsRegistrarConfiguration은 Microsoft.Rtc.Management.WritableConfig.Settings.Registrar.RegistrarSettings 개체의 새 인스턴스를 만듭니다.
예제
-------------------------- 예제 1 --------------------------
New-CsRegistrarConfiguration -Identity site:Redmond -MaxEndpointsPerUser 4 -EnableDHCPServer $True
위 명령은 Redmond 사이트에 대한 새 등록자 구성 설정 컬렉션을 만듭니다(-Identity site:Redmond). 이 명령은 새 설정의 ID를 지정할 뿐 아니라 사용자당 최대 끝점 수를 4개로 설정하고(-MaxEndpointsPerUser 4) 클라이언트 등록에 DHCP 서버를 사용할 수 있도록 설정합니다(-EnableDHCPServer $True). Redmond 사이트에 등록자 구성 설정 컬렉션이 이미 할당된 경우 이 명령은 실패합니다.
-------------------------- 예제 2 --------------------------
$x = New-CsRegistrarConfiguration -Identity site:Redmond -InMemory
$x.MaxEndpointsPerUser = 4
$x.EnableDHCPServer = $True
Set-CsRegistrarConfiguration -Instance $x
또한 예제 2에 표시된 명령은 Redmond 사이트(-Identity site:Redmond)에 대한 새 등록자 구성 설정 컬렉션을 만듭니다. 그러나 이 예제에서는 이러한 설정이 처음에 메모리에만 만들어지고 나중에 사이트 자체에 적용됩니다.
이 작업을 수행하기 위해 첫 번째 명령은 New-CsRegistrarConfiguration을 사용하여 site:Redmond에 대한 새 설정 컬렉션을 만듭니다. 이러한 설정이 메모리에만 만들어지고 Redmond 사이트에 즉시 적용되지 않도록 InMemory 매개 변수를 명령 끝에 추가합니다. 이러한 설정은 메모리에만 존재하므로 변수에 저장해야 합니다. 이 예제에서는 $x라는 변수를 사용합니다.
두 번째 및 세 번째 명령은 새 가상 설정의 두 가지 속성(MaxEndpointsPerUser 및 EnableDHCPServer)을 수정합니다. 이 예제의 마지막 명령은 Set-CsRegistrarConfiguration을 사용하여 $x에 저장된 가상 설정을 Redmond 사이트에 적용되는 실제 등록자 구성 설정 집합으로 변환합니다. Set-CsRegistrarConfiguration을 호출하지 않으면 Redmond 사이트에 대한 새 설정이 만들어지지 않으며, Windows PowerShell 세션을 종료하거나 변수 $x를 삭제하는 즉시 가상 설정이 사라집니다.