Get-CsPinPolicy
마지막으로 수정된 항목: 2012-03-23
조직에서 사용하도록 구성된 클라이언트 PIN(개인 ID 번호) 인증 정책에 대한 정보를 반환합니다. PIN 인증을 통해 사용자는 사용자 이름 및 암호 대신 PIN을 제공하여 Microsoft Lync Server 2010에 액세스할 수 있습니다.
구문
Get-CsPinPolicy [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]
Get-CsPinPolicy [-Filter <String>] [-LocalStore <SwitchParameter>]
자세한 정보
Lync Server 2010을 사용하면 사용자가 전화를 통해 시스템에 연결하거나 PSTN(공중 전화망) 전화 회의에 참가할 수 있습니다. 일반적으로 사용자가 시스템에 로그온하거나 전화 회의에 참가하려면 사용자 이름 또는 암호를 입력해야 하지만 영숫자 키패드가 없는 전화기를 사용하는 경우 사용자 이름 및 암호를 입력하기 어려울 수 있습니다. 따라서 Lync Server 2010는 사용자에게 숫자로만 구성된 PIN을 제공할 수 있도록 지원합니다. PIN을 묻는 메시지가 표시되면 사용자 이름 및 암호 대신 PIN을 입력하여 시스템에 로그온하거나 전화 회의에 참가할 수 있습니다.
Lync Server에서는 PIN 정책을 사용하여 PIN 인증 속성을 관리합니다. 예를 들어 PIN의 최소 길이를 지정하고 연속된 숫자(예: 123456과 같은 PIN) 등의 "공통 패턴"을 사용하는 PIN의 허용 여부를 결정할 수 있습니다. Get-CsPinPolicy cmdlet을 사용하여 조직에서 사용하도록 현재 구성된 PIN 정책에 대한 정보를 검색할 수 있습니다.
이 cmdlet을 실행할 수 있는 사용자: 기본적으로 RTCUniversalUserAdmins 및 RTCUniversalServerAdmins 그룹의 구성원은 Get-CsPinPolicy cmdlet을 로컬로 실행할 수 있습니다. 사용자가 직접 만든 사용자 지정 RBAC(역할 기반 액세스 제어) 역할을 포함하여 이 cmdlet이 할당된 모든 RBAC 역할의 목록을 가져오려면 Windows PowerShell 프롬프트에서 다음 명령을 실행합니다.
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsPinPolicy"}
매개 변수
| 매개 변수 | 필수 | 유형 | 설명 |
|---|---|---|---|
Identity |
선택 |
Xds ID |
정책이 만들어질 때 정책에 할당된 고유 ID입니다. PIN 정책은 전역, 사이트 또는 사용자별 범위에서 할당할 수 있습니다. 글로벌 인스턴스를 참조하려면 -Identity global 구문을 사용합니다. 사이트 범위의 정책을 참조하려면 -Identity site:Redmond 구문을 사용합니다. 사용자별 범위의 정책을 참조하려면 -Identity RedmondPolicy와 유사한 구문을 사용합니다. 별표(*)와 같은 와일드카드 문자는 Identity 매개 변수에 사용할 수 없습니다. 정책에 대해 와일드카드 검색을 수행하려면 Filter 매개 변수를 대신 사용합니다. Identity 및 Filter 매개 변수를 둘 다 지정하지 않으면 Get-CsPinPolicy에서 조직에서 사용하도록 구성된 모든 PIN 정책에 대한 정보를 반환합니다. |
Filter |
선택 |
문자열 |
PIN 정책에 대해 와일드카드 검색을 수행할 수 있습니다. 예를 들어 사이트 범위에 구성된 모든 정책을 찾아보려면 site:* 필터를 사용합니다. 사이트 정책 Seattle, Seville 및 Saskatoon(모두 문자 "S"로 시작함)을 찾으려면 site:S* 필터를 사용합니다. 이 매개 변수는 Identity 속성에 대해서만 필터링할 수 있습니다. |
LocalStore |
선택 |
스위치 매개 변수 |
중앙 관리 저장소 자체가 아니라 중앙 관리 저장소의 로컬 복제본에서 PIN 정책 데이터를 검색합니다. |
입력 형식
없음. Get-CsPinPolicy는 파이프라인된 입력을 허용하지 않습니다.
반환 형식
Get-CsPinPolicy는 Microsoft.Rtc.Management.WritableConfig.Policy.UserPin.UserPinPolicy 개체의 인스턴스를 하나 이상 반환합니다.
예제
-------------------------- 예제 1 ------------------------
Get-CsPinPolicy
예제 1에 표시된 명령은 조직에서 사용하도록 구성된 모든 PIN 정책 컬렉션을 반환합니다. 매개 변수 없이 Get-CsPinPolicy를 호출하면 항상 전체 PIN 정책 집합이 반환됩니다.
-------------------------- 예제 2 ------------------------
Get-CsPinPolicy -Identity "site:Redmond"
예제 2에서는 Identity가 site:Redmond인 단일 PIN 정책을 반환합니다.
-------------------------- 예제 3 ------------------------
Get-CsPinPolicy -Filter "tag:*"
예제 3에 표시된 명령은 Filter 매개 변수를 사용하여 사용자별 범위에서 구성된 모든 정책을 반환합니다. 이 작업을 수행하기 위해 필터 값 "tag:*"를 사용합니다. 이 값은 Identity가 "tag:" 문자로 시작하는 정책만 반환하도록 Get-CsPinPolicy에 지시합니다.
-------------------------- 예제 4 ------------------------
Get-CsPinPolicy | Where-Object {$_.AllowCommonPatterns -eq $True}
예제 4에서는 AllowCommonPatterns 속성이 True인 모든 PIN 정책을 반환합니다. 이 예제에서는 먼저 추가 매개 변수 없이 Get-CsPinPolicy를 호출하여 조직에서 사용하도록 구성된 모든 PIN 정책 컬렉션을 반환합니다. 이 컬렉션은 AllowCommonPatterns 속성이 True와 같은 정책만 선택하는 Where-Object cmdlet에 전달됩니다.
-------------------------- 예제 5 ------------------------
Get-CsPinPolicy | Where-Object {$_.PinLifetime -gt 30}
예제 4와 마찬가지로, 예제 5에 표시된 명령은 Where-Object를 사용하여 기존 PIN 정책의 하위 집합을 반환합니다. 이 예제의 Where-Object는 PinLifetime 속성이 30보다 큰 정책만 검색합니다. 즉, PIN 만료 시간이 30일보다 큰 정책만 반환됩니다.