New-CsVoiceRoute

Skype for Business Server 2015
 

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

Создает новый голосовой маршрут. Голосовые маршруты содержат инструкции, на основании которых Skype для бизнеса Server 2015 маршрутизирует вызовы, поступающие от пользователей корпоративной голосовой связи на номера телефонов PSTN или PBX. Данный командлет впервые появился в Lync Server 2010.

New-CsVoiceRoute -Name <String> <COMMON PARAMETERS>
New-CsVoiceRoute -Identity <XdsGlobalRelativeIdentity> <COMMON PARAMETERS>
COMMON PARAMETERS: [-AlternateCallerId <String>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-NumberPattern <String>] [-Priority <Int32>] [-PstnGatewayList <PSListModifier>] [-PstnUsages <PSListModifier>] [-SuppressCallerId <$true | $false>] [-WhatIf [<SwitchParameter>]]

Команда, показанная в этом примере, создает новый голосовой маршрут с идентификатором (значение свойства Identity) Route1. Всем остальным свойствам присваиваются значения по умолчанию.

New-CsVoiceRoute -Identity Route1

Команда, показанная в этом примере, создает новый голосовой маршрут с идентификатором Route1. Кроме того, она добавляет вариант Long Distance (междугородные звонки) в список вариантов использования PSTN и идентификатор службы PstnGateway:redmondpool.litwareinc.com — в список шлюзов PSTN.

New-CsVoiceRoute -Identity Route1 -PstnUsages @{add="Long Distance"} -PstnGatewayList @{add="PstnGateway:redmondpool.litwareinc.com"}

В этом примере создается новый голосовой маршрут с именем Route1 и заполняется его список вариантов использования PSTN всеми существующими в организации вариантами использования. Первая команда получает глобальный список вариантов использования PSTN. Обратите внимание, что вызов командлета Get-CsPstnUsage указан в скобках; это означает, что сначала извлекается объект, содержащий сведения об использовании PSTN. (Поскольку существует только один, глобальный, вариант использования PSTN, будет получен только один объект). Затем команда извлекает свойство Usage этого объекта. Это свойство, которое содержит список вариантов использования, присваивается переменной $x. Во второй строке примера вызывается командлет New-CsVoiceRoute для создания нового голосового маршрута. Этому маршруту присваивается идентификатор Route1. Обратите внимание на значение, передаваемое для параметра PstnUsages: @{add=$x}. Это значение добавляет содержимое переменной $x, которая содержит список вариантов использования телефона, полученный в первой строке, к списку вариантов использования PSTN для данного маршрута.

$x = (Get-CsPstnUsage).Usage
New-CsVoiceRoute -Identity Route1 -PstnUsages @{add=$x}

Этот командлет используется для создания нового голосового маршрута. Все голосовые маршруты создаются в глобальной области действия. Тем не менее, можно определить несколько глобальных голосовых маршрутов. Для этого используется параметр Identity, которому присваивается уникальное имя маршрута.

Голосовые маршруты связаны с политиками голосовой службы через варианты использования PSTN. Голосовой маршрут содержит регулярное выражение, которое определяет, какие номера телефонов будут маршрутизироваться посредством данного маршрута: это будут номера телефонов, соответствующие регулярному выражению.

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

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

 

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

Identity

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

Microsoft.Rtc.Management.Xds.XdsGlobalRelativeIdentity

Имя, которое уникально идентифицирует голосовой маршрут. Голосовые маршруты могут определяться только в глобальной области, поэтому идентификатор — это просто имя, которое вы задаете для маршрута. (Имя маршрута может содержать пробелы (например, Test Route), но в вызове командлета New-CsVoiceRoute вся строка должна заключаться в двойные кавычки).

Если указан параметр Identity, параметр Name должен быть пустым. Значение Identity будет присвоено параметру Name.

Name

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

System.String

Уникальное имя голосового маршрута. Если этот параметр задан, его значение будет автоматически применено к идентификатору голосового маршрута. Параметры Identity и Name нельзя задавать одновременно.

AlternateCallerId

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

System.String

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

Если параметру SuppressCallerId присвоено значение False, параметр AlternateCallerId игнорируется.

Это значение должно соответствовать регулярному выражению (\+)?[1-9]\d*(;ext=[1-9]\d*)?. Другими словами, значение может начинаться со знака "плюс" (+), но необязательно; должно состоять из любого количества цифр; может заканчиваться выражением, начинающимся с ;ext= и содержащим любое количество цифр. (При использовании добавочного номера строка должна быть заключена в двойные кавычки.)

Confirm

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

System.Management.Automation.SwitchParameter

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

Description

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

System.String

Описание назначения голосового маршрута.

Force

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

System.Management.Automation.SwitchParameter

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

InMemory

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

System.Management.Automation.SwitchParameter

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

NumberPattern

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

System.String

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

Значение по умолчанию: [0-9]{10}

Priority

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

System.Int32

Номер может разрешаться в несколько голосовых маршрутов. Приоритет определяет порядок, в котором будут применяться маршруты в этом случае.

PstnGatewayList

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

System.Management.Automation.PSListModifier

В Skype для бизнеса Server 2015 служба посредник может быть связана с несколькими шлюзами. Этот параметр содержит список шлюзов, связанных с данным голосовым маршрутом. Каждый элемент этого списка должен быть служебным идентификатором шлюза PSTN или посредник. Значение может ссылаться на посредник, только если служба посредник настроена для Microsoft Office Communications Server 2007 или Microsoft Office Communications Server 2007 R2. Для Skype для бизнеса Server 2015 должен использоваться шлюз PSTN. Служебный идентификатор — это строка в формате <ServiceRole>:<FQDN>, где ServiceRole — это имя роли службы (PSTNGateway), а FQDN — полное доменное имя пула или IP-адрес сервера. Например, PSTNGateway:redmondpool.litwareinc.com. Служебные идентификаторы можно получить с помощью команды Get-CsService | Select-Object Identity.

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

PstnUsages

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

System.Management.Automation.PSListModifier

Список вариантов использования PSTN (например Local, Long Distance и т. д.), которые могут применяться к данному голосовому маршруту. Варианты использования PSTN должны существовать. (Варианты использования PSTN можно получить с помощью командлета Get-CsPstnUsage .)

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

SuppressCallerId

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

System.Boolean

Определяет, будет ли показываться идентификатор звонящего при исходящих вызовах. Если этот параметр имеет значение True, идентификатор звонящего не будет показываться. Вместо фактического идентификатора будет отображаться значение параметра AlternateCallerId. Если параметр SuppressCallerId имеет значение True, должно быть указано значение AlternateCallerId.

WhatIf

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

System.Management.Automation.SwitchParameter

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

Создает объект типа Microsoft.Rtc.Management.WritableConfig.Policy.Voice.Route.

 
Показ: