New-CsClientVersionPolicyRule

구문

New-CsClientVersionPolicyRule -Identity <XdsIdentity> [-Action <Allow | AllowAndUpgrade | AllowWithUrl | Block | BlockAndUpgrade | BlockWithUrl>] [-ActionUrl <String>] [-BuildNumber <Nullable>] [-CompareOp <EQL | NEQ | GTR | GEQ | LSS | LEQ>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-MajorVersion <UInt16>] [-MinorVersion <Nullable>] [-Priority <Int32>] [-QfeNumber <Nullable>] [-UserAgent <String>] [-UserAgentFullName <String>] [-WhatIf [<SwitchParameter>]]

New-CsClientVersionPolicyRule -Parent <String> -RuleId <String> [-Action <Allow | AllowAndUpgrade | AllowWithUrl | Block | BlockAndUpgrade | BlockWithUrl>] [-ActionUrl <String>] [-BuildNumber <Nullable>] [-CompareOp <EQL | NEQ | GTR | GEQ | LSS | LEQ>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-MajorVersion <UInt16>] [-MinorVersion <Nullable>] [-Priority <Int32>] [-QfeNumber <Nullable>] [-UserAgent <String>] [-UserAgentFullName <String>] [-WhatIf [<SwitchParameter>]]

자세한 정보

클라이언트 버전 정책 규칙은 Lync Server 2010에 로그온할 수 있는 클라이언트 응용 프로그램을 결정하는 데 사용됩니다. 사용자가 Lync Server 2010에 로그온하려고 하면 클라이언트 응용 프로그램이 서버에 SIP 헤더를 전송합니다. 이 헤더에는 소프트웨어의 주 버전, 부 버전, 빌드 번호 등 응용 프로그램 자체에 대한 자세한 정보가 포함되어 있습니다. 그 다음에는 버전 정보를 클라이언트 버전 규칙의 컬렉션과 대조하여 해당하는 특정 응용 프로그램에 적용되는 규칙이 있는지 확인합니다. 예를 들어 사용자가 Microsoft Office Communicator 2007 R2를 사용하여 로그온하려는 경우를 가정해 보겠습니다. 사용자가 Lync Server 2010에 로그인하기 전에 시스템에서 Office Communicator 2007 R2에 적용되는 클라이언트 버전 규칙이 있는지 확인합니다. 규칙이 있으면 Lync Server 2010에서 해당 규칙에 의해 지정된 작업을 수행합니다. 해당 동작은 다음 중 하나여야 합니다.

Allow. 사용자에게 로그온이 허용됩니다.

AllowAndUpgrade. 사용자에게 로그온이 허용되고, 이 사용자의 Communicator 2007 R2가 최신 버전의 Lync로 자동으로 업그레이드됩니다. 업그레이드는 시스템 구성 방법에 따라 Microsoft Update 또는 Windows Server Update Services를 사용하여 수행됩니다.

AllowWithUrl. 사용자에게 로그온이 허용되고, 최신 버전의 Lync를 다운로드하여 설치할 수 있는 URL로 이동되는 메시지가 표시됩니다. 이 URL은 Lync Server를 설치할 때 자동으로 만들어진 사이트가 아니라 사용자가 만든 웹 사이트를 가리켜야 합니다.

Block. 사용자에게 로그온이 허용되지 않습니다.

BlockAndUpgrade. 사용자에게 로그온이 허용되지는 않지만, 이 사용자의 Communicator 2007 R2가 최신 버전의 Lync로 자동으로 업그레이드됩니다. 그러면 사용자가 새 클라이언트 응용 프로그램을 사용하여 로그온할 수 있습니다. 업그레이드는 시스템 구성 방법에 따라 Microsoft Update 또는 Windows Server Update Services를 사용하여 수행됩니다.

BlockWithUrl. 사용자에게 로그온이 허용되지는 않지만, 최신 버전의 Lync를 다운로드하여 설치할 수 있는 URL로 이동되는 메시지가 표시됩니다. 이 URL은 Lync Server를 설치할 때 자동으로 만들어진 사이트가 아니라 사용자가 만든 웹 사이트를 가리켜야 합니다.

클라이언트 버전 정책 규칙은 글로벌 범위, 사이트 범위, 서비스 범위(등록자 서비스) 또는 사용자별 범위에서 구성할 수 있는 클라이언트 버전 정책에서 수집됩니다. 새 클라이언트 버전 규칙은 New-CsClientVersionPolicyRule cmdlet을 사용하여 만듭니다. 새 규칙을 만들 때는 해당 규칙의 ID도 지정해야 합니다. 이 ID는 범위(예: site:Redmond) 및 GUID(Globally Unique Identifier)로 구성됩니다. ID 자체를 조합하거나 범위(Parent 매개 변수) 및 GUID(RuleId 매개 변수)를 제공하고 New-CsClientVerisonPolicyRule을 사용하여 사용자의 ID를 만들 수도 있습니다.

클라이언트 버전 정책은 페더레이션 사용자에게 적용되지 않습니다. 대신 페더레이션 사용자에게는 조직에서 사용되는 클라이언트 버전 정책이 적용됩니다. 예를 들어 페더레이션 사용자가 클라이언트 A를 사용하고, 이 클라이언트가 페더레이션 조직에서 허용된다고 가정해 보겠습니다. 페더레이션 조직에서 클라이언트 A 사용을 허용하는 한 이 사용자는 해당 클라이언트를 사용하여 조직과 통신할 수 있습니다. 이는 클라이언트 버전 정책이 클라이언트 A 사용을 차단하는 경우에도 마찬가지입니다. 조직에서 시행되는 클라이언트 버전 정책은 페더레이션 조직에서 사용되는 클라이언트 버전 정책을 무시하지 않습니다.

이 cmdlet을 실행할 수 있는 사용자: 기본적으로 RTCUniversalServerAdmins 그룹의 구성원은 New-CsClientVersionPolicyRule cmdlet을 로컬로 실행할 수 있습니다. 사용자가 직접 만든 사용자 지정 RBAC(역할 기반 액세스 제어) 역할을 포함하여 이 cmdlet이 할당된 모든 RBAC 역할의 목록을 가져오려면 Windows PowerShell 프롬프트에서 다음 명령을 실행합니다.

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsClientVersionPolicyRule"}

매개 변수

입력 형식

없음. New-CsClientVersionPolicyRule은 파이프라인된 입력을 허용하지 않습니다.

반환 형식

New-CsClientVersionPolicyRule은 Microsoft.Rtc.Management.WritableConfig.Policy.ClientVersion.Rule 개체의 새 인스턴스를 만듭니다.

예제

-------------------------- 예제 1 --------------------------

$x = [guid]::NewGuid()

New-CsClientVersionPolicyRule -Parent "site:Redmond" -RuleId $x -MajorVersion 4 -UserAgent InHouse

예제 1은 새 클라이언트 버전 정책 규칙을 만드는 방법을 보여 줍니다. 정책 규칙에는 알림을 할당할 범위와 36자로 된 GUID의 두 부분으로 구성된 ID가 있습니다. 새 클라이언트 버전 정책 규칙의 ID를 먼저 만들려면 .NET Framework 메서드인 NewGuid를 사용하여 새 GUID를 만들어야 합니다. 이 단계는 예제의 첫 번째 명령을 수행하는 단계이며, 결과 GUID는 변수 $x에 저장됩니다.

GUID를 만든 후에는 New-CsClientVersionPolicyRule을 사용하여 새 규칙을 만들 수 있습니다. 이 명령은 네 가지 매개 변수를 사용합니다. 즉, 새 규칙의 범위(site:Redmond)를 나타내는 매개 변수 값을 사용하는 Parent, 매개 변수 값 $x를 사용하는 RuleId(새로 만든 GUID를 나타냄), MajorVersion(4), UserAgent(InHouse)를 사용합니다. 이 경우 UserAgent 매개 변수는 사내 클라이언트 응용 프로그램을 나타냅니다.

-------------------------- 예제 2 --------------------------

$x = [guid]::NewGuid()

$z = New-CsClientVersionPolicyRule -Parent "site:Redmond" -RuleId $x -InMemory
$z.MajorVersion = 4 
$z.UserAgent = "Inhouse"
Set-CsClientVersionPolicyRule -Instance $z

예제 2에 표시된 명령은 예제 1에 표시된 명령이 변형된 것입니다. 그러나 이 경우에는 새 규칙이 처음에 메모리에만 만들어지고 나중에 Lync Server 2010에 추가됩니다. 이 작업을 수행하기 위해 예제의 첫 번째 명령은 ID의 GUID 부분을 만듭니다. 두 번째 명령에서는 메모리에만 나타나는 새로운 클라이언트 버전 정책 규칙이 만들어집니다. -InMemory 매개 변수는 규칙이 메모리에만 존재하고 Lync Server 2010 인프라에 즉시 추가되지 않도록 합니다. 예제 1에서와 마찬가지로 Parent 및 Id 매개 변수를 사용하여 규칙 ID를 지정하는 두 부분인 새 규칙의 범위와 GUID를 지정합니다.

가상 규칙을 만든 후에는 다음 두 명령을 사용하여 MajorVersion 및 UserAgent 속성에 각각 값을 할당합니다. 해당 작업이 완료되면 예제의 마지막 명령 및 Set-CsClientVersionPolicyRule cmdlet을 사용하여 실제 클라이언트 버전 정책 규칙을 만들고 이 규칙을 Redmond 사이트에 할당합니다.

참고 항목

기타 리소스

Get-CsClientVersionPolicyRule
Remove-CsClientVersionPolicyRule
Set-CsClientVersionPolicyRule