New-CsPinPolicy

구문

New-CsPinPolicy -Identity <XdsIdentity> [-AllowCommonPatterns <$true | $false>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-MaximumLogonAttempts <Nullable>] [-MinPasswordLength <UInt32>] [-PINHistoryCount <UInt64>] [-PINLifetime <UInt64>] [-WhatIf [<SwitchParameter>]]

자세한 정보

Lync Server 2010을 사용하면 사용자가 전화를 통해 시스템에 연결하거나 PSTN(공중 전화망) 전화 회의에 참가할 수 있습니다. 사용자는 일반적으로 사용자 이름 또는 암호를 입력하여 시스템에 로그온하거나 전화 회의에 참가하지만 영숫자 키패드가 없는 전화기를 사용하는 경우 사용자 이름 및 암호를 입력하기 어려울 수 있습니다. 따라서 Lync Server는 사용자에게 숫자로만 구성된 PIN을 제공할 수 있도록 지원합니다. PIN을 묻는 메시지가 표시되면 사용자 이름 및 암호 대신 PIN을 입력하여 로그온하거나 전화 회의에 참가할 수 있습니다.

Lync Server에서는 PIN 정책을 사용하여 PIN 인증 속성을 관리합니다. 예를 들어 PIN의 최소 길이를 지정하고 연속된 숫자(예: 123456와 같은 PIN) 등의 "공통 패턴"을 사용하는 PIN의 허용 여부를 결정할 수 있습니다. New-CsPinPolicy cmdlet을 사용하면 새 PIN 인증 정책을 만들 수 있습니다. 이러한 새 정책은 사이트 범위나 사용자별 범위에서 구성할 수 있습니다. 글로벌 PIN 정책도 있습니다. 그러나 글로벌 PIN 정책을 추가로 또 만들 수는 없습니다. 사용자는 기존 글로벌 정책을 수정할 수 밖에 없습니다.

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

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

매개 변수

입력 형식

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

반환 형식

Microsoft.Rtc.Management.WritableConfig.Policy.UserPin.UserPolicy 개체의 새 인스턴스를 만듭니다.

예제

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

New-CsPinPolicy -Identity "site:Redmond" -MinPasswordLength 10

예제 1에서는 New-CsPinPolicy를 사용하여 ID가 site:Redmond인 새 PIN 정책을 만듭니다. 이 명령에는 단 하나의 선택 매개 변수인 -MinPasswordLength가 포함됩니다. 이 매개 변수는 MinPasswordLength 속성을 10으로 설정하는 데 사용됩니다. 나머지 모든 정책 속성은 기본값을 사용하여 구성됩니다.

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

New-CsPinPolicy -Identity "site:Redmond" -MinPasswordLength 10 -PINHistoryCount 10 -PINLifetime 30

예제 2에 표시된 명령은 ID가 site:Redmond인 새 정책을 만듭니다. 이 명령은 MinPasswordLength, PINHistoryCount 및 PINLifetime 매개 변수를 사용하여 새 정책의 세 가지 속성 값을 명시적으로 구성합니다.

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

$x = New-CsPinPolicy -Identity "site:Redmond" -InMemory
$x.MinPasswordLength = 10
$x.PINHistoryCount = 10
$x.PINLifetime = 30
Set-CsPinPolicy -Instance $x

예제 3에 표시된 명령은 새 PIN 정책을 메모리에만 만들고, 해당 정책의 속성 값을 수정한 다음, Set-CsPinPolicy를 사용하여 메모리에만 나타나는 정책을 실제 PIN 정책으로 변환하는 방법을 보여 줍니다. 위의 첫 번째 줄에서 New-CsPinPolicy 및 InMemory 매개 변수를 사용하여 ID가 site:Redmond이고 메모리에만 나타나는 정책을 만듭니다. 이 정책은 변수 $x에 저장됩니다. 변수에 정책을 할당하지 않으면 정책이 메모리에만 만들어진 다음 명령을 완료하자마자 즉시 사라집니다.

가상 정책을 변수 $x에 할당한 후에는 그다음 세 가지 명령을 사용하여 해당 정책의 속성 값을 수정합니다. 예를 들어 두 번째 줄은 MinPasswordLength 속성의 값을 10으로 설정합니다. 모든 속성을 구성한 후에는 Set-CsPinPolicy를 사용하여 ID가 site:Redmond인 실제 정책을 만듭니다. 이 작업은 Instance 매개 변수를 사용하고 변수 $x를 매개 변수 값으로 전달하여 수행됩니다. Set-CsPinPolicy를 호출한 후에는 Get-CsPinPolicy cmdlet을 사용하여 정책 및 해당 속성 값을 볼 수 있습니다.

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

$x = Get-CsPinPolicy -Identity "site:Redmond"
New-CsPinPolicy -Identity "site:Paris" -MinPasswordLength $x.MinPasswordLength 

예제 4에 사용된 명령은 기존 정책 site:Redmond에 있는 속성 값 중 하나를 사용하는 새 PIN 정책(site:Paris)을 만듭니다. 이 작업을 수행하기 위해 첫 번째 명령은 Get-CsPinPolicy를 사용하여 PIN 정책 site:Redmond를 검색합니다. 이 정책에 대해 검색된 정보는 변수 $x에 저장됩니다.

두 번째 명령에서는 New-CsPinPolicy를 사용하여 site:Paris 정책을 만듭니다. 그리고 MinPasswordLength 매개 변수를 사용하여 MinPasswordLength 속성의 값을 지정합니다. 그러나 이 명령은 하드 코드된 숫자 값을 사용하는 대신 $x.MinPasswordLength를 매개 변수 값으로 사용합니다. 그러면 New-CsPinPolicy에서 최소 암호 길이를 site:Redmond 정책에 있는 MinPasswordLength 속성의 값으로 설정하게 됩니다. 최종적으로 MinPasswordLength 속성의 값이 기존 정책 site:Redmond에서 새 정책 site:Paris로 복사됩니다.

참고 항목

기타 리소스

Get-CsPinPolicy
Grant-CsPinPolicy
Remove-CsPinPolicy
Set-CsPinPolicy