Grant-CsDialPlan
마지막으로 수정된 항목: 2012-03-23
다이얼 플랜을 하나 이상의 사용자나 그룹에 할당합니다.
구문
Grant-CsDialPlan -Identity <UserIdParameter> [-PolicyName <String>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-PassThru <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
자세한 정보
이 cmdlet은 기존 사용자별 다이얼 플랜을 사용자에게 할당합니다. 다이얼 플랜은 Enterprise Voice 사용자가 전화 통화를 할 수 있는 데 필요한 정보를 제공합니다. 유효한 다이얼 플랜이 없는 사용자는 Enterprise Voice를 사용하여 전화를 걸 수 없습니다. 다이얼 플랜은 정규화 규칙이 어떻게 적용되는지, 외부 통화를 위해 접두사를 사용해야 하는지 여부 등을 결정합니다.
사용자별 다이얼 플랜이 사용자에게 부여되었는지 여부를 확인하려면 Get-CsUser "<user name>" | Select-Object DialPlan 형식의 명령을 호출합니다. 예를 들면 다음과 같습니다.
Get-CsUser "Ken Myer" | Select-Object DialPlan
이 cmdlet을 실행할 수 있는 사용자: 기본적으로 RTCUniversalUserAdmins 그룹의 구성원은 Grant-CsDialPlan cmdlet을 로컬로 실행할 수 있습니다. 사용자가 직접 만든 사용자 지정 RBAC(역할 기반 액세스 제어) 역할을 포함하여 이 cmdlet이 할당된 모든 RBAC 역할의 목록을 가져오려면 Windows PowerShell 프롬프트에서 다음 명령을 실행합니다.
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Grant-CsDialPlan"}
매개 변수
| 매개 변수 | 필수 | 유형 | 설명 |
|---|---|---|---|
Identity |
필수 |
사용자 ID 매개 변수 |
다이얼 플랜을 할당할 사용자의 ID(고유 식별자)입니다. 사용자 ID는 네 가지 형식 중 하나를 사용하여 지정할 수 있는데, 이러한 형식은 1) 사용자의 SIP 주소, 2) 사용자의 UPN(사용자 계정 이름), 3) domain\logon 형태인 사용자의 도메인 이름 및 로그온 이름(예: litwareinc\kenmyer) 및 4) 사용자의 Active Directory 표시 이름(예: Ken Myer)입니다. 표시 이름을 사용자 ID로 사용할 경우 별표(*) 와일드카드 문자를 사용할 수 있습니다. 예를 들어, ID "* Smith"는 성이 Smith인 모든 사용자를 반환합니다. 전체 데이터 형식: Microsoft.Rtc.Management.AD.UserIdParameter |
PolicyName |
선택 |
문자열 |
사용자에게 할당할 다이얼 플랜의 ID 값입니다. (ID의 이름 부분만 여기에 포함됩니다. 사용자별 다이얼 플랜 ID는 PolicyName에 포함되지 않아야 하는 접두사 tag:를 포함합니다.) |
DomainController |
선택 |
Fqdn |
도메인 컨트롤러를 지정하도록 합니다. 도메인 컨트롤러를 지정하지 않으면 사용 가능한 첫 번째 도메인 컨트롤러가 사용됩니다. |
PassThru |
선택 |
스위치 매개 변수 |
명령 결과를 반환합니다. 기본적으로 이 cmdlet에서는 출력을 생성하지 않습니다. |
WhatIf |
선택 |
스위치 매개 변수 |
명령을 실제로 실행하지 않고도 명령이 실행될 경우 발생할 수 있는 현상을 설명합니다. |
Confirm |
선택 |
스위치 매개 변수 |
명령을 실행하기 전에 확인 메시지를 표시합니다. |
입력 형식
문자열. 다이얼 플랜을 할당할 사용자 계정의 ID를 나타내는 파이프라인된 문자열 값을 허용합니다.
반환 형식
PassThru 매개 변수와 함께 사용된 경우 Microsoft.Rtc.Management.ADConnect.Schema.OCSADUserOrAppContact 개체 유형을 반환합니다.
예제
-------------------------- 예제 1 --------------------------
Grant-CsDialPlan -Identity "Ken Myer" -PolicyName RedmondDialPlan
위 예제에서는 Grant-CsDialPlan을 사용하여 RedmondDialPlan 다이얼 플랜을 ID(이 경우 표시 이름)가 Ken Myer인 사용자에게 할당합니다.
-------------------------- 예제 2 --------------------------
Get-CsUser -LDAPFilter "l=Redmond" | Grant-CsDialPlan -PolicyName RedmondDialPlan
예제 2에서는 Redmond에 사무실이 있는 모든 사용자에게 RedmondDialPlan 다이얼 플랜을 할당합니다. 이를 위해 Get-CsUser cmdlet을 호출하여 Redmond 시에 사무실이 있는 모든 사용자의 컬렉션을 검색합니다. 이 작업은 LDAPFilter 매개 변수와 LDAP 쿼리 l=Redmond를 사용하여 수행됩니다. AD DS(Active Directory 도메인 서비스)에 사용되는 LDAP 쿼리 언어에서 l는 사용자의 "locality", 즉 구/군/시를 나타냅니다. 이 컬렉션은 컬렉션의 각 사용자에게 Redmond 다이얼 플랜을 할당하는 Grant-CsDialPlan에 파이프됩니다.