Grant-CsDialPlan

Skype for Business Server 2015
 

Дата изменения раздела:2017-03-28

Назначает абонентскую группу одному или нескольким пользователям или группам. Данный командлет впервые появился в Lync Server 2010.

Grant-CsDialPlan -Identity <UserIdParameter> -PolicyName <String> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-PassThru <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

В примере командлет Grant-CsDialPlan используется для назначения абонентской группы RedmondDialPlan пользователю с идентификатором (в данном случае это отображаемое имя) "Ken Myer".

Grant-CsDialPlan -Identity "Ken Myer" -PolicyName RedmondDialPlan

В примере 2 абонентская группа RedmondDialPlan назначается всем пользователям, офисы которых расположены в городе Редмонд. Для этого вызывается командлет Get-CsUser , который возвращает коллекцию всех пользователей с офисами в городе Редмонд. При этом используется параметр LdapFilter и LDAP-запрос "l=Redmond". (В языке запросов LDAP, используемом в Active Directory, символ "l" обозначает местоположение пользователя или город.) Эта коллекция затем передается в командлет Grant-CsDialPlan , который назначает абонентскую группу Redmond каждому пользователю в коллекции.

Get-CsUser -LDAPFilter "l=Redmond" | Grant-CsDialPlan -PolicyName RedmondDialPlan

Данный командлет назначает существующую абонентскую группу пользователю. Абонентские группы предоставляют сведения, позволяющие пользователям корпоративной голосовой связи совершать телефонные вызовы. Пользователи, не входящие в правильную абонентскую группу, не могут выполнять звонки с помощью службы Enterprise Voice. Абонентская группа определяет такие свойства, как применение правил нормализации и следует ли добавлять префикс при выполнении внешних звонков.

Чтобы проверить, назначена ли пользователю абонентская группа, можно вызвать команду с аргументами следующего вида: Get-CsUser "<user name>" | Select-Object DialPlan. Например:

Get-CsUser "Ken Myer" | Select-Object DialPlan

По умолчанию локально запускать командлет Grant-CsDialPlan имеют право члены группы RTCUniversalUserAdmins. Чтобы получить список всех ролей управления доступом на основе ролей (RBAC), которым назначен этот командлет (включая все настраиваемые роли RBAC, созданные вами), запустите следующую команду из командной строки Windows PowerShell:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Grant-CsDialPlan"}

 

Параметр Обязательный? Тип Описание

Identity

Обязательный

Microsoft.Rtc.Management.AD.UserIdParameter

Идентификатор (уникальный) пользователя, которому назначается абонентская группа.

Идентификаторы пользователей могут быть указаны в следующих форматах: 1)SIP-адрес пользователя; 2) имя участника-пользователя (UPN); 3) доменное имя и логин пользователя, в виде домен\логин (например, litwareinc\kenmyer); 4) отображаемое имя пользователя Active Directory (например, Ken Myer).

При использовании отображаемого имени в качестве идентификатора допустимо применение подстановочного символа звездочки (*). Например, идентификатор "* Smith", вернет всех пользователей с фамилией "Smith".

Полный тип данных: Microsoft.Rtc.Management.AD.UserIdParameter

PolicyName

Обязательный

System.String

Значение идентификатора абонентской группы, назначаемой пользователю. (Содержит только именную часть идентификатора. Идентификаторы индивидуальных абонентских групп содержат префикс "tag:", который не должен указываться в параметре PolicyName.)

Confirm

Необязательный

System.Management.Automation.SwitchParameter

Запрашивает подтверждение перед выполнением команды.

DomainController

Необязательный

Microsoft.Rtc.Management.Deploy.Fqdn

Позволяет указать контроллер домена. Если контроллер домен не указан, то будет использован первый доступный.

PassThru

Необязательный

System.Management.Automation.SwitchParameter

Возвращает результаты выполнения команды. По умолчанию командлет не формирует какие-либо результаты выполнения.

WhatIf

Необязательный

System.Management.Automation.SwitchParameter

Описывает, что произойдет при выполнении команды без реального выполнения команды.

Строка. Принимает из конвейера строковое значение, представляющее идентификатор пользовательской учетной записи, которой назначается абонентская группа.

При использовании с параметром PassThru возвращает объект типа Microsoft.Rtc.Management.ADConnect.Schema.OCSADUserOrAppContact.

 
Показ: