New-CsDialPlan

Skype for Business Server 2015
 

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

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

New-CsDialPlan -Identity <XdsIdentity> [-City <String>] [-Confirm [<SwitchParameter>]] [-CountryCode <String>] [-Description <String>] [-DialinConferencingRegion <String>] [-ExternalAccessPrefix <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-NormalizationRules <PSListModifier>] [-OptimizeDeviceDialing <$true | $false>] [-SimpleName <String>] [-State <String>] [-WhatIf [<SwitchParameter>]]

Команда в примере 1 создает новую абонентскую группу со свойством Identity, равным RedmondDialPlan. (Отсутствие области действия в значении Identity указывает, что это политика на уровне пользователей. Абонентские группы, создаваемые на уровне пользователей, могут назначаться напрямую пользователям и группам.) Всем остальным свойствам абонентской группы присваиваются значения по умолчанию.

New-CsDialPlan -Identity RedmondDialPlan

Команды в примере 2 создают новую абонентскую группу со свойством Identity, равным site:Redmond (это значит, что абонентская группа применяется ко всем пользователям сайта Redmond, которым не назначена абонентская группа на уровне пользователей или служб) и со свойством SimpleName, равным RedmondSiteDialPlan. Следующая строка в примере создает новое правило нормализации, связанное с этой группой. Для абонентской группы создается правило нормализации по умолчанию, однако оно скорее выступает в роли заполнителя, поскольку его значения имеют весьма ограниченное применение. Поэтому после вызова командлета New-CsDialPlan для создания новой абонентской группы нужно вызвать командлет New-CsVoiceNormalizationRule для создания именованного правила, которое будет использоваться в организации. Именно это и выполняется во второй строке этого примера: вызывается командлет New-CsVoiceNormalizationRule и создается правило для сайта Redmond с именем SeattlePrefix и указанием свойств Pattern и Translation для правила. Для изменения абонентской группы других действий не требуется; изменения правила нормализации автоматически применяются к абонентской группе с идентификатором, совпадающим с идентификатором этого правила. (Элемент site:Redmond свойства Identity совпадает со свойством Identity абонентской группы; SeattlePrefix — это имя правила нормализации. К одной абонентской группе может применяться несколько правил нормализации, поэтому каждому правилу нормализации необходимо уникальное имя в заданной области действия).

New-CsDialPlan -Identity site:Redmond -SimpleName RedmondSiteDialPlan
New-CsVoiceNormalizationRule -Identity "site:Redmond/SeattlePrefix" -Pattern "^9(\d*){1,5}$" -Translation "+1206$1"

Команда в примере 3 создает новую абонентскую группу со свойством Identity, равным RedmondDialPlan, и в свойстве Description указывает назначение абонентской группы. (Абонентские группы, создаваемые на уровне пользователей, могут назначаться напрямую пользователям и группам.) Всем остальным параметрам присваиваются значения по умолчанию.

New-CsDialPlan -Identity RedmondDialPlan -Description "Dial plan for Redmond users"

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

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

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

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

 

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

Identity

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

Microsoft.Rtc.Management.Xds.XdsIdentity

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

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 в количестве от одной до четырех.

По умолчанию: 9

Force

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

System.Management.Automation.SwitchParameter

Отключение всех запросов на подтверждение при внесении изменений.

InMemory

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

System.Management.Automation.SwitchParameter

Создает ссылку на объект без фиксации объекта в качестве постоянного изменения. Если выходные данные этого командлета, вызванного с помощью указанного параметра, назначаются переменной, можно внести изменения в свойства ссылки на объект и затем зафиксировать эти изменения, вызвав соответствующий командлет Set-<cmdlet> .

NormalizationRules

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

System.Management.Automation.PSListModifier

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

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

Каждый раз при создании новой абонентской группы также создается новое правило нормализации голосовых служб с параметрами по умолчанию для этой абонентской группы на уровне сайта, служб или пользователей. По умолчанию значение Identity нового правила нормализации голосовых служб равно значению Identity абонентской группы плюс косая черта плюс строка "Prefix All". Например: Redmond/Prefix All.

По умолчанию: {Description=;Pattern=^(\d11)$;Translation=+$1;Name=Prefix All;IsInternalExtension=False } Примечание. Такое значение по умолчанию является просто заполнителем. Чтобы в существовании абонентской группы был смысл, следует либо изменить правило нормализации, созданное при создании абонентской группы, либо создать новое правило на уровне сайта, служб или пользователей. Создать новое правило нормализации можно с помощью командлета New-CsVoiceNormalizationRule ; изменить правило нормализации можно с помощью командлета Set-CsVoiceNormalizationRule .

OptimizeDeviceDialing

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

System.Boolean

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

Значение по умолчанию: False

SimpleName

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

System.String

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

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

Этот параметр должен иметь значение. Однако если при вызове командлета New-CsDialPlan значение не указывается, то будет подставлено значение по умолчанию. Значением по умолчанию для глобальной абонентской группы является Prefix All. Значением по умолчанию для абонентской группы на уровне сайта является название сайта. Значением по умолчанию на уровне служб является имя службы (регистратора или шлюза ТСОП) плюс подчеркивание плюс полное доменное имя службы. Например, Registrar_pool0.litwareinc.com. Значением по умолчанию для абонентской группы на уровне пользователей является значение Identity абонентской группы.

State

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

System.String

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

WhatIf

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

System.Management.Automation.SwitchParameter

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

Этот командлет создает объект типа Microsoft.Rtc.Management.WritableConfig.Policy.Voice.LocationProfile.

 
Показ: