Get-CsClientPolicy

 

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

조직에서 사용하도록 구성된 클라이언트 정책에 대한 정보를 반환합니다. 특히 클라이언트 정책은 사용자가 사용할 수 있는 비즈니스용 Skype 서버 2015 기능을 결정하는 데 도움이 됩니다. 예를 들어 일부 사용자에게는 파일 전송 권한을 부여하고 다른 사용자에 대해서는 이 권한을 거부할 수 있습니다. 이 cmdlet은 Lync Server 2010에서 도입되었습니다.

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

예제 1에서는 추가 매개 변수 없이 Get-CsClientPolicy cmdlet을 호출합니다. 그러면 조직에서 사용하도록 구성된 모든 클라이언트 정책 컬렉션이 반환됩니다.

Get-CsClientPolicy

예제 2에서는 Get-CsClientPolicy cmdlet을 사용하여 ID가 SalesPolicy인 사용자별 클라이언트 정책을 반환합니다. ID는 고유하므로 이 명령은 두 개 이상의 항목을 반환하지 않습니다.

Get-CsClientPolicy -Identity SalesPolicy

예제 3에서는 Filter 매개 변수를 사용하여 사용자별 범위에서 구성된 모든 클라이언트 정책을 반환합니다. 필터 값 "tag:*"는 ID가 문자열 값 "tag:"으로 시작하는 정책만 반환하도록 Get-CsClientPolicy cmdlet에 지시합니다.

Get-CsClientPolicy -Filter "tag:*"

예제 4에서는 DisableSavingIM 속성이 True인 모든 클라이언트 정책 컬렉션을 반환합니다. 이 작업을 수행하기 위해 먼저 매개 변수 없이 Get-CsClientPolicy cmdlet을 호출하여 조직에서 사용하도록 구성된 모든 클라이언트 정책 컬렉션을 반환합니다. 이 컬렉션은 DisableSavingIM 속성이 True와 같은 정책만 선택하는 Where-Object cmdlet에 파이프됩니다.

Get-CsClientPolicy | Where-Object {$_.DisableSavingIM -eq $True}

예제 5에서는 DisableSavingIM 속성이 True이고 EnableIMAutoArchiving 속성이 False여야 한다는 두 가지 조건을 충족하는 클라이언트 정책만 반환합니다. 이 작업을 수행하기 위해 명령은 먼저 Get-CsClientPolicy cmdlet을 호출하여 조직에서 사용하도록 구성된 모든 클라이언트 정책 컬렉션을 반환합니다. 이 컬렉션은 DisableSavingIM이 True와 같고 EnableIMAutoArchiving이 False와 같아야 한다는 두 조건을 모두 충족하는 정책만 선택하는 Where-Object cmdlet에 파이프됩니다. -and 연산자는 지정된 조건을 모두 충족하는 개체만 선택하도록 Where-Object cmdlet에 지시합니다.

Get-CsClientPolicy | Where-Object {$_.DisableSavingIM -eq $True -and $_.EnableIMAutoArchiving -eq $False}

예제 6은 예제 5에 표시된 명령의 변형입니다. 그러나 이 예제에서는 DisableSavingIM 속성이 True인 조건과 EnableIMAutoArchiving 속성이 False인 조건 중 하나 또는 둘 다를 충족하는 정책을 선택합니다. 이 작업을 수행하기 위해 명령은 먼저 Get-CsClientPolicy cmdlet을 호출하여 조직에서 사용하도록 구성된 모든 클라이언트 정책 컬렉션을 반환합니다. 이 컬렉션은 DisableSavingIM이 True와 같다는 조건과 EnableIMAutoArchiving이 False와 같다는 조건 중 하나 또는 둘 다를 충족하는 정책만 선택하는 Where-Object cmdlet에 파이프됩니다. -or 연산자는 지정된 조건 중 하나 이상을 충족하는 개체를 선택하도록 Where-Object cmdlet에 지시합니다.

클라이언트 정책은 로그온한 위치 및 로그온하는 데 사용한 장치 유형에 관계없이 사용자가 시스템에 액세스할 때마다 적용됩니다. 또한 다른 비즈니스용 Skype 서버 2015 정책과 마찬가지로 클라이언트 정책을 언제든지 선택한 사용자 그룹으로 지정할 수 있을 뿐만 아니라 단일 사용자에게 할당되는 사용자 지정 정책을 만들 수도 있습니다.

클라이언트 정책은 전역, 사이트 및 사용자별 범위에서 구성할 수 있습니다. Get-CsClientPolicy cmdlet을 사용하면 조직에서 사용하도록 구성된 모든 클라이언트 정책에 대한 정보를 반환할 수 있습니다.

 

매개 변수 필수 유형 설명

Filter

선택

System.String

반환할 정책을 지정할 때 와일드카드 문자를 활용하는 데 사용됩니다. 예를 들어 사이트 범위에서 구성된 모든 정책을 반환하려면 -Filter "site:*" 구문을 사용하고, 모든 사용자별 정책 컬렉션을 반환하려면 -Filter "tag:*" 구문을 사용합니다.

Identity

선택

Microsoft.Rtc.Management.Xds.XdsIdentity

반환할 클라이언트 정책의 고유 식별자입니다. 전역 정책을 참조하려면 -Identity site:Redmond 구문을 사용하고, 사이트 정책을 참조하려면 -Identity site:Redmond와 유사한 구문을 사용합니다. 사용자별 정책을 참조하려면-Identity SalesDepartmentPolicy와 유사한 구문을 사용합니다.

이 매개 변수가 없으면 조직에서 사용하도록 구성된 모든 클라이언트 정책이 반환됩니다.

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-CsClientPolicy cmdlet은 파이프라인된 입력을 허용하지 않습니다.

Get-CsClientPolicy cmdlet은 Microsoft.Rtc.Management.WritableConfig.Policy.Client.ClientPolicy 개체의 인스턴스를 반환합니다.

 
표시: