Get-CsClientVersionPolicyRule

구문

Get-CsClientVersionPolicyRule [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]

Get-CsClientVersionPolicyRule [-Filter <String>] [-LocalStore <SwitchParameter>]

자세한 정보

클라이언트 버전 정책 규칙은 Microsoft 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를 설치할 때 자동으로 만들어진 사이트가 아니라 사용자가 만든 웹 사이트를 가리켜야 합니다.

클라이언트 버전 규칙은 클라이언트 버전 정책에서 수집됩니다. 이러한 정책은 글로벌 범위, 사이트 범위, 서비스 범위(등록자 서비스) 또는 사용자별 범위에서 구성될 수 있습니다. Get-CsClientVersionPolicyRule cmdlet을 사용하면 관리자가 조직에서 사용하도록 구성된 각 정책 규칙에 대한 자세한 정보를 볼 수 있습니다.

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

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

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

매개 변수

입력 형식

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

반환 형식

Get-CsClientVersionPolicyRule은 Microsoft.Rtc.Management.WritableConfig.Policy.ClientVersion.Rule 개체의 인스턴스를 반환합니다.

예제

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

Get-CsClientVersionPolicyRule

예제 1에서는 조직에서 현재 사용 중인 모든 클라이언트 버전 정책 규칙에 대한 정보를 반환합니다.

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

Get-CsClientVersionPolicyRule -Identity "Global/2336c611-a243-4c5d-994b-eea8a524d0e4"

예제 2에서는 ID가 Global/2336c611-a243-4c5d-994b-eea8a524d0e4인 단일 클라이언트 버전 정책 규칙에 대한 정보를 반환합니다.

-------------------------- 예제 3 --------------------------

Get-CsClientVersionPolicyRule -Filter "Global/*"

위의 명령은 글로벌 범위에 구성된 모든 클라이언트 버전 정책 규칙을 반환합니다. 이 작업을 수행하기 위해 명령은 Filter 매개 변수 및 필터 값 "Global/*"을 사용합니다. 이 필터 값은 ID가 "Global/" 문자열 값으로 시작하는 규칙만 반환합니다.

-------------------------- 예제 4 --------------------------

Get-CsClientVersionPolicyRule | Where-Object {$_.Enabled -eq $False}

예제 4에 표시된 명령은 현재 사용하지 않도록 설정된 모든 클라이언트 버전 정책 규칙을 반환합니다. 이 작업을 수행하기 위해 명령은 먼저 Get-CsClientVersionPolicy를 호출하여 사용 가능한 클라이언트 정책 규칙을 모두 반환합니다. 이 컬렉션은 Enabled 속성이 False와 같은 규칙을 선택하는 Where-Object cmdlet에 파이프됩니다.

-------------------------- 예제 5 ------------------------

Get-CsClientVersionPolicyRule | Where-Object {$_.Action -eq "Block"}

위의 명령은 클라이언트 응용 프로그램의 로그온을 차단하는 모든 클라이언트 버전 정책 규칙을 반환합니다. 이 작업을 수행하기 위해 명령은 먼저 Get-CsClientVersionPolicy를 매개 변수 없이 호출합니다. 그러면 현재 사용 중인 모든 규칙의 컬렉션이 반환됩니다. 그런 다음 이 컬렉션은 Action 속성이 Block과 같은 규칙만 선택하는 Where-Object cmdlet에 파이프됩니다.

참고 항목

기타 리소스

New-CsClientVersionPolicyRule
Remove-CsClientVersionPolicyRule
Set-CsClientVersionPolicyRule