Set-CsDialPlan

Skype for Business Server 2015
 

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

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

Set-CsDialPlan [-Identity <XdsIdentity>] <COMMON PARAMETERS>
Set-CsDialPlan [-Instance <PSObject>] <COMMON PARAMETERS>
COMMON PARAMETERS: [-City <String>] [-Confirm [<SwitchParameter>]] [-CountryCode <String>] [-Description <String>] [-DialinConferencingRegion <String>] [-ExternalAccessPrefix <String>] [-Force <SwitchParameter>] [-NormalizationRules <PSListModifier>] [-OptimizeDeviceDialing <$true | $false>] [-SimpleName <String>] [-State <String>] [-WhatIf [<SwitchParameter>]]

В примере 1 командлет Set-CsDialPlan используется для изменения абонентской группы с идентификатором RedmondDialPlan. В данном случае изменяется только свойство Description; это осуществляется с помощью указания параметра Description с текстом для нового описания.

Set-CsDialPlan -Identity RedmondDialPlan -Description "This plan is for Redmond-based users only."

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

Get-CsDialPlan | Set-CsDialPlan -ExternalAccessPrefix 8

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

Примечание. Хотя с помощью этого командлета можно изменить правила нормализации абонентской группы, рекомендуется использовать вместо него командлеты New-CsVoiceNormalizationRule , Set -CsVoiceNormalizationRule или Remove-CsVoiceNormalizationRule . Внесенные с помощью этих командлетов изменения отражаются в соответствующей абонентской группе.

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

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

 

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

City

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

System.String

Этот параметр не используется с данным командлетом.

Confirm

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

System.Management.Automation.SwitchParameter

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

CountryCode

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

System.String

Этот параметр не используется с данным командлетом.

Description

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

System.String

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

Максимальное число символов: 512

DialinConferencingRegion

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

System.String

Название региона, сопоставленного с этой абонентской группой. Укажите значение для этого параметра, если абонентская группа будет использоваться для конференц-связи с телефонным подключением. Это позволяет назначить правильный номер доступа, когда организатор конференции настраивает конференцию. Доступные регионы можно восстановить с помощью вызова командлета Get-CsNetworkRegion .

Максимальное число символов: 512

ExternalAccessPrefix

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

System.String

Число (или набор чисел), который обозначает звонок как внешний по отношению к организации. (Например, чтобы вызвать внешнюю телефонную линию, нажмите 9.) Правила нормализации игнорируют этот префикс, хотя и применяются к остальной части номера.

Чтобы это значение вступило в силу, необходимо установить для параметра OptimizeDeviceDialing значение True.

Значение этого параметра должно соответствовать регулярному выражению [0-9]{1,4}. Это значит, что оно должно иметь длину от одной до четырех цифр, а каждая из этих цифр может принимать значение от 0 до 9.

Force

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

System.Management.Automation.SwitchParameter

Подавляет запросы подтверждения до внесения изменений.

Identity

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

Microsoft.Rtc.Management.Xds.XdsIdentity

Уникальный идентификатор, обозначающий область — или имя для индивидуальных групп — для определения абонентской группы, которую вы хотите изменить. Например, идентификатор Identity сайта будет иметь формат site:<имя_сайта>, где "имя_сайта" — это имя сайта. Абонентская группа в области службы будет службой шлюза регистратора или PSTN, где значение Identity имеет следующий формат: Registrar:Redmond.litwareinc.com. Индивидуальный идентификатор Identity будет уникальным строковым значением.

Instance

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

LocationProfile

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

NormalizationRules

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

System.Management.Automation.PSListModifier

Список правил нормализации, применяемых к этой абонентской группе.

Хотя этот список и эти правила можно непосредственно изменить с помощью данного командлета, вам рекомендуется использовать для создания правил нормализации командлет New-CsVoiceNormalizationRule , который создает правило и назначает его указанной абонентской группе, а для изменения — командлет Set-CsVoiceNormalizationRule .

OptimizeDeviceDialing

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

System.Boolean

При установке значения True для этого параметра к звонкам, выполняемым за пределы организации, будет применяться префикс из параметра ExternalAccessPrefix. Если параметр ExternalAccessPrefix имеет заданное значение, то для данного параметра можно установить только значение True.

SimpleName

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

System.String

Понятное имя для абонентской группы. Имена всех абонентских групп в рамках развертывания Skype для бизнеса Server 2015 должны быть уникальными.

Эта строка может иметь длину до 256 символов. Допускается использовать буквы алфавита и числа, дефис (-), точку (.), знак плюс (+), знак подчеркивания (_) и скобки (()).

State

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

System.String

Этот параметр не используется с данным командлетом.

WhatIf

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

System.Management.Automation.SwitchParameter

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

Объект Microsoft.Rtc.Management.WritableConfig.Policy.Voice.LocationProfile. Принимает в качестве входных данных объекты абонентской группы, переданные по конвейеру.

Командлет Set-CsDialPlan не возвращает значение или объект. Вместо этого он настраивает экземпляры объекта Microsoft.Rtc.Management.WritableConfig.Policy.Voice.LocationProfile.

 
Показ: