New-CsUCPhoneConfiguration
마지막으로 수정된 항목: 2012-03-26
Microsoft Lync 2010 Phone Edition을 관리하는 데 사용되는 새 설정 컬렉션을 만듭니다. 이러한 설정을 사용하여 필요한 보안 모드 등을 구성하고 전화가 지정된 시간 동안 비활성 상태일 경우 자동으로 잠글지 여부를 지정할 수 있습니다.
구문
New-CsUCPhoneConfiguration -Identity <XdsIdentity> [-CalendarPollInterval <TimeSpan>] [-Confirm [<SwitchParameter>]] [-EnforcePhoneLock <$true | $false>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-LoggingLevel <Off | Low | Medium | High>] [-MinPhonePinLength <Byte>] [-PhoneLockTimeout <TimeSpan>] [-SIPSecurityMode <Low | Medium | High>] [-Voice8021p <Byte>] [-VoiceDiffServTag <Byte>] [-WhatIf [<SwitchParameter>]]
자세한 정보
Lync 2010 Phone Edition은 전화와 Microsoft Lync 2010의 병합을 나타냅니다. Lync 2010 Phone Edition은 VoIP(Voice over Internet Protocol) 전화로 작동할 수 있는 특정 하드웨어(즉, Lync 2010 호환 전화)를 사용합니다. 또한 이 하드웨어는 Lync 2010와 같은 끝점 역할을 할 수도 있습니다. 현재 상태를 설정하고, Lync 2010 대화 상대의 상태를 확인하고, 새 대화 상대를 검색하고, Lync 2010를 사용하여 수행하던 기타 여러 작업을 수행할 수 있습니다.
Lync Server 2010에는 Lync 2010을 실행하는 전화를 관리하는 데 사용할 수 있는 다양한 cmdlet이 제공됩니다. 예를 들어 전화에 로그온하는 데 사용되는 PIN(개인 ID 번호)의 최소 길이 및 전화가 지정된 시간 동안 비활성 상태일 경우 자동으로 잠글지 여부 등을 제어할 수 있습니다.
UC(Unified Communications) 전화 구성 설정은 글로벌 범위 또는 사이트 범위에 적용할 수 있습니다. 사이트 범위에 적용되는 설정이 글로벌 범위에 적용되는 설정보다 우선합니다. Lync Server를 처음 설치하면 단일 UC 전화 구성 설정 집합이 생성되어 글로벌 범위에 적용됩니다. 그러나 이후에 언제든지 New-CsUCPhoneConfiguration cmdlet을 사용하여 사이트 범위에서 적용된 설정 컬렉션을 만들 수 있습니다. 이렇게 하면 각 개별 사이트의 고유한 요구 사항에 맞게 UC 전화 관리를 조정할 수 있습니다.
New-CsUCPhoneConfiguration을 사용하면 사이트 범위에 새 UC 전화 설정을 만들 수 있습니다. 앞서 말했듯이 사이트당 설정 컬렉션을 하나만 만들 수 있습니다. 예를 들어 ID가 site:Redmond인 설정 컬렉션을 만들려고 하는데 레드몬드 사이트에 이미 할당된 UC 전화 설정 집합이 있다고 가정해 보겠습니다. 이 경우 명령이 실패하게 됩니다. 대신에 기존 설정을 제거한 다음 New-CsUCPhoneConfiguration을 사용하여 새 설정 컬렉션을 만들거나 Set-CsUCPhoneConfiguration을 사용하여 기존 설정을 수정해야 합니다.
글로벌 범위에는 새 설정 컬렉션을 만들 수 없습니다. 글로벌 범위에 수행할 수 있는 유일한 작업은 Set-CsUCPhoneConfiguration을 사용하여 기존 설정을 수정하는 것입니다.
이 cmdlet을 실행할 수 있는 사용자: 기본적으로 RTCUniversalServerAdmins 그룹의 구성원은 New-CsUCPhoneConfiguration cmdlet을 로컬로 실행할 수 있습니다. 사용자가 직접 만든 사용자 지정 RBAC(역할 기반 액세스 제어) 역할을 포함하여 이 cmdlet이 할당된 모든 RBAC 역할의 목록을 가져오려면 Windows PowerShell 프롬프트에서 다음 명령을 실행합니다.
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsUCPhoneConfiguration"}
매개 변수
| 매개 변수 | 필수 | 유형 | 설명 |
|---|---|---|---|
Identity |
필수 |
Xds ID |
UC 전화 구성 설정의 새 컬렉션에 할당할 고유한 식별자를 나타냅니다. 사이트 범위에서만 새 컬렉션을 생성할 수 있기 때문에 ID의 접두사는 항상 "site:"이며 사이트 이름이 오는 "site:Redmond"와 같은 형식이 됩니다. |
CalendarPollInterval |
선택 |
시간 범위 |
UC 장치가 Microsoft Outlook 일정에서 정보를 검색하는 빈도를 지정합니다. 값은 시간:분:초 형식을 사용하여 지정해야 합니다. 예를 들어 시간 간격을 1시간(최대 허용 간격)으로 설정하려면 -CalendarPollInterval "01:00:00" 구문을 사용합니다. 기본값은 3분(00:03:00)입니다. |
EnforcePhoneLock |
선택 |
부울 |
PhoneLockTimeout에 지정된 시간(분)이 지나면 UC 전화를 자동으로 잠글지 여부를 지정합니다. 기본값은 True입니다. |
LoggingLevel |
선택 |
문자열 |
UC 장치에 로깅하는 데 사용됩니다. 유효한 값은 Off, Low, Medium 및 High입니다. 기본값은 Off입니다. |
MinPhonePinLength |
선택 |
바이트 |
PIN(개인 ID 번호)에 필요한 최소 자릿수를 지정합니다. 최소값: 4 최대값: 15 기본값: 6 |
PhoneLockTimeout |
선택 |
시간 범위 |
UC 전화가 자동으로 잠기기 전에 유휴 상태로 유지되는 시간(분)을 지정합니다. 이 값은 01:00:00(1시간)보다 작아야 합니다. 기본값은 00:10:00(10분)입니다. |
SIPSecurityMode |
선택 |
SIP 보안 모드 |
서버가 UC 전화에서 시작된 SIP 세션에 적용할 보안 수준을 지정합니다. 사용할 수 있는 값은 다음과 같습니다. Low(모든 유형의 인증 또는 전송 허용). Medium(사용자 인증에 NTLM 또는 Kerberos 필요). High(사용자 인증에 NTLM 또는 Kerberos 필요, SIP 연결에 TLS 필요). 기본값은 High입니다. |
Voice8021p |
선택 |
바이트 |
Lync Server 2010 배포 내에서 음성 트래픽의 사용자 우선 순위 값(802.1p 값)을 지정합니다. 이 설정은 스위치와 브리지가 802.1p를 지원하는 네트워크에만 적용됩니다. 이 속성의 최소값은 0이고, 최대값은 7입니다. 기본값은 0입니다. |
VoiceDiffServTag |
선택 |
바이트 |
6비트 DSCP(Differentiated Services Code Point) 우선 순위 표시의 소수점 표현을 지정합니다. 이 표시는 이 서버에서 관리하는 UC 전화가 전달한 IP 패킷의 PHB(홉당 동작)를 정의합니다. 이 값은 0-63(포함) 사이에 있어야 합니다. 기본값은 40입니다. |
Force |
선택 |
스위치 매개 변수 |
명령을 실행할 때 발생할 수 있는 심각하지 않은 오류 메시지를 표시하지 않습니다. |
InMemory |
선택 |
스위치 매개 변수 |
개체를 실제로 영구 변경 사항으로 커밋하지 않고 개체 참조를 만듭니다. 이 매개 변수와 함께 호출된 이 cmdlet의 결과를 변수로 할당하면 개체 참조의 속성을 변경한 후 이 cmdlet과 일치하는 Set- cmdlet을 호출하여 해당 변경 사항을 커밋할 수 있습니다. |
WhatIf |
선택 |
스위치 매개 변수 |
명령을 실제로 실행하지 않고도 명령이 실행될 경우 발생할 수 있는 현상을 설명합니다. |
Confirm |
선택 |
스위치 매개 변수 |
명령을 실행하기 전에 확인 메시지를 표시합니다. |
입력 형식
없음. New-CsUCPhoneConfiguration은 파이프라인된 입력을 허용하지 않습니다.
반환 형식
Microsoft.Rtc.Management.WritableConfig.Policy.Voice.UcPhoneSettings 개체의 인스턴스를 만듭니다.
예제
-------------------------- 예제 1 --------------------------
New-CsUCPhoneConfiguration -Identity site:Redmond -CalendarPollInterval "00:10:00" -LoggingLevel "Medium"
위 명령은 레드몬드 사이트에 대한 UC 전화 설정의 새 컬렉션을 만듭니다. 이 예제에서는 필수 매개 변수와 함께 두 가지 선택적 매개 변수가 포함됩니다. 하나는 일정 폴링 시간 간격을 10분(00시간:10분:00초)으로 설정하는 Identity:CalendarPollInterval이고 다른 하나는 UC 전화 로깅 수준을 Medium으로 설정하는 LoggingLevel입니다. 이 명령이 완료되는 즉시 레드몬드 사이트에 새 설정이 적용되고 해당 사이트의 사용자의 UC 전화가 새 설정으로 관리됩니다. 레드몬드 사이트에 이미 UC 전화 설정 컬렉션이 있는 경우 이 명령은 실패하게 됩니다.
-------------------------- 예제 2 --------------------------
$x = New-CsUCPhoneConfiguration -Identity site:Redmond -InMemory
$x.CalendarPollInterval = "00:10:00"
$x.LoggingLevel = "Medium"
Set-CsUCPhoneConfiguration -Instance $x
예제 2에서는 InMemory 매개 변수의 사용법을 보여 줍니다. 이 매개 변수를 사용하여 메모리에만 존재하는 새 UC 전화 설정 집합을 만들 수 있습니다. 이러한 설정은 $x 변수에 저장됩니다. 이 가상 컬렉션이 생성되면 예제의 둘째 줄과 셋째 줄에 표시된 것과 유사한 명령을 사용하여 메모리 내부 전용 설정을 수정할 수 있습니다. 둘째 줄에서는 CalendarPollInterval 속성이 10분(00시간: 10분: 00초)으로 설정되어 있고 셋째 줄에서는 LoggingLevel 속성이 Medium으로 설정되어 있습니다.
속성 값 수정을 완료한 후 Set-CsUCPhoneConfiguration을 사용하여 $x에 저장된 가상 설정을 Redmond 사이트에 적용된 실제 설정의 컬렉션으로 전환할 수 있습니다. InMemory 매개 변수를 사용하면 Set-CsUCPhoneConfiguration을 호출하기 전까지 설정이 실제로 적용되지 않습니다. 이 cmdlet을 호출하지 않으면 Windows PowerShell 세션을 종료하거나 $x 변수를 삭제할 때 가상 설정이 사라집니다.