Get-CsDialPlan

Skype for Business Server 2015
 

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

Возвращает сведения о абонентских группах, используемых в организации. Данный командлет впервые появился в Lync Server 2010.

Get-CsDialPlan [-Identity <XdsIdentity>] <COMMON PARAMETERS>
Get-CsDialPlan [-Filter <String>] <COMMON PARAMETERS>
COMMON PARAMETERS: [-LocalStore <SwitchParameter>]

В примере 1 возвращается коллекция всех абонентских групп, настроенных для использования в вашей организации; для этого выполняется вызов командлета Get-CsDialPlan без дополнительных параметров.

Get-CsDialPlan

В примере 2 параметр Identity используется для ограничения полученных данных в абонентских группах, которые содержат индивидуальную абонентскую группу с удостоверением RedmondDialPlan. Так как идентификаторы должны быть уникальны, эта команда будет возвращать только определенную абонентскую группу.

Get-CsDialPlan -Identity RedmondDialPlan

Пример 3 идентичен примеру 2, за исключением того, что вместо получения индивидуальной абонентской группы, возвращается абонентская группа, назначенная для сайта. Это делается путем установки параметра site: за которым следует имя сайта (в этом случае Редмонд), который мы хотим получить.

Get-CsDialPlan -Identity site:Redmond

В этом примере параметр Filter используется для возврата коллекции всех абонентских групп, которые были настроены в индивидуальной области пользователя. (Параметры, которые настроены для отдельных пользователей или для тега, область может быть прямо назначена пользователям и группам.) Тег строки подстановки tag:* указывает, что командлет возвращает только те абонентские группы, которые имеют удостоверение, начинающееся со строки tag, а также идентифицирует абонентскую группу как индивидуальную.

Get-CsDialPlan -Filter tag:*

Этот пример отображает правила нормализации, используемые абонентскими группами, настроенные для использования в организации. Так как свойство NormalizationRules содержит массив объектов, полный набор правил нормализации обычно не отображается на экране. Чтобы просмотреть все эти правила, простая команда использует командлет Get-CsDialPlan , чтобы получить коллекцию всех абонентских групп. Затем, эта коллекция передается по конвейеру в командлет Select-Object ; в свою очередь параметр ExpandProperty командлета Select-Object используется, чтобы развернуть значения, которые содержатся в свойстве NormalizationRules. Развертка значений означает, что все правила нормализации будут перечислены по отдельности на экране, а также будут выведены при вызове командлета Get-CsVoiceNormalizationRule .

Get-CsDialPlan | Select-Object -ExpandProperty NormalizationRules

В примере 6 командлеты Get-CsDialPlan и Where-Object используются для получения коллекции всех абонентских групп, включая слово Redmond в их описании. Для этого команда сначала использует командлет Get-CsDialPlan , чтобы получить все абонентские группы. Затем, эта коллекция передается через конвейер в командлет Where-Object , в котором применяется фильтр, ограничивающий возвращаемые в профили данные со словом Redmond в их описании.

Get-CsDialPlan | Where-Object {$_.Description -match "Redmond"}

Этот командлет возвращает сведения об одном или нескольких абонентских группах (также известных как профили местоположения) в организации. Абонентские группы предоставляют сведения, необходимые для разрешения пользователям голосовой связи предприятия осуществлять телефонные звонки. Кроме того, абонентские группы используются приложения помощника по конференц-связи для конференций с входящим подключением. В абонентской группе определяются: применяемые правила нормализации и должен ли набираться префикс для внешних звонков.

Примечание. Можно воспользоваться командлетом Get-CsDialPlan , чтобы получить специальные сведения о правилах нормализации абонентской группы, но, если это именно та информация, которая вам необходима, используйте командлет Get-CsVoiceNormalizationRule .

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

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

 

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

Filter

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

System.String

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

Identity

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

Microsoft.Rtc.Management.Xds.XdsIdentity

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

LocalStore

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

System.Management.Automation.SwitchParameter

Возвращает сведения об абонентских группах из локальной реплики центрального хранилища управления, а не из самого центрального хранилища управления.

Данный командлет возвращает экземпляры объекта Microsoft.Rtc.Management.WritableConfig.Policy.Voice.LocationProfile.

 
Показ: