Get-CsClientVersionPolicyRule

 

마지막으로 수정된 항목: 2017-03-28

조직에서 사용하도록 구성된 클라이언트 버전 정책 규칙을 반환합니다. 이 cmdlet은 Lync Server 2010에서 도입되었습니다.

Get-CsClientVersionPolicyRule [-Identity <XdsIdentity>] <COMMON PARAMETERS>
Get-CsClientVersionPolicyRule [-Filter <String>] <COMMON PARAMETERS>
COMMON PARAMETERS: [-LocalStore <SwitchParameter>] [-Tenant <Guid>]

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

Get-CsClientVersionPolicyRule

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

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

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

Get-CsClientVersionPolicyRule -Filter "Global/*"

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

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

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

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

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

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

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

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

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

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

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

클라이언트 버전 규칙은 클라이언트 버전 정책에서 수집됩니다. 이러한 정책은 전역 범위, 사이트 범위, 서비스 범위(등록자 서비스) 또는 사용자별 범위에서 구성될 수 있습니다. 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"}

 

매개 변수 필수 유형 설명

Filter

선택

System.String

반환할 클라이언트 버전 정책 규칙을 지정할 때 와일드카드 문자를 활용하는 데 사용됩니다. 예를 들어 Redmond 사이트에 구성된 모든 규칙을 반환하려면 -Filter "site:Redmond/*" 구문을 사용합니다.

Filter 매개 변수와 Identity 매개 변수를 같은 명령에 함께 사용할 수 없습니다.

Identity

선택

Microsoft.Rtc.Management.Xds.XdsIdentity

검색할 클라이언트 버전 정책 규칙의 고유 식별자입니다. 클라이언트 버전 규칙의 ID는 규칙이 구성된 범위와 GUID(Globally Unique Identifier)로 구성됩니다. 즉, 규칙의 ID는 site:Redmond/1987d3c2-4544-489d-bbe3-59f79f530a83과 유사한 형태가 됩니다. GUID는 기억하기 어렵기 때문에 이 도움말 항목의 예제 섹션에서는 반환할 규칙을 식별할 수 있는 다른 방법을 보여 줍니다.

이 매개 변수가 지정되지 않으면 사용하도록 구성된 모든 클라이언트 버전 정책 규칙이 반환됩니다.

LocalStore

선택

System.Management.Automation.SwitchParameter

중앙 관리 저장소 자체가 아니라 중앙 관리 저장소의 로컬 복제본에서 클라이언트 버전 정책 규칙 데이터를 검색합니다.

Tenant

선택

System.Guid

클라이언트 버전 정책 규칙이 반환되는 비즈니스용 Skype 온라인 테넌트 계정의 GUID(Globally Unique Identifier)입니다. 예를 들면 다음과 같습니다.

–Tenant "38aad667-af54-4397-aaa7-e94c79ec2308"

다음 명령을 실행하여 각 비즈니스용 Skype 온라인 테넌트의 테넌트 ID를 반환할 수 있습니다.

Get-CsTenant | Select-Object DisplayName, TenantID

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

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

 
표시: