Поделиться через


Set-UMDialplan

 

Применимо к: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Последнее изменение раздела: 2012-03-26

Командлет Set-UMDialplan позволяет определить свойства абонентской группы единой системы обмена сообщениями.

Синтаксис

Set-UMDialPlan -Identity <UMDialPlanIdParameter> [-AccessTelephoneNumbers <MultiValuedProperty>] [-AllowDialPlanSubscribers <$true | $false>] [-AllowedInCountryOrRegionGroups <MultiValuedProperty>] [-AllowedInternationalGroups <MultiValuedProperty>] [-AllowExtensions <$true | $false>] [-AudioCodec <G711 | Wma | Gsm>] [-AutomaticSpeechRecognitionEnabled <$true | $false>] [-CallSomeoneEnabled <$true | $false>] [-ConfiguredInCountryOrRegionGroups <MultiValuedProperty>] [-ConfiguredInternationalGroups <MultiValuedProperty>] [-Confirm [<SwitchParameter>]] [-ContactAddressList <AddressListIdParameter>] [-ContactRecipientContainer <OrganizationalUnitIdParameter>] [-ContactScope <DialPlan | GlobalAddressList | Extension | AutoAttendantLink | AddressList>] [-CountryOrRegionCode <String>] [-DefaultLanguage <UMLanguage>] [-DialByNamePrimary <LastFirst | FirstLast | SMTPAddress>] [-DialByNameSecondary <LastFirst | FirstLast | SMTPAddress | None>] [-DomainController <Fqdn>] [-EquivalenceDialPlan <Guid>] [-Extension <String>] [-FaxEnabled <$true | $false>] [-FDSPollingInterval <Int32>] [-InCountryOrRegionNumberFormat <NumberFormat>] [-InfoAnnouncementEnabled <True | False | Uninteruptible>] [-InfoAnnouncementFilename <String>] [-InputFailuresBeforeDisconnect <Int32>] [-InputRetries <Int32>] [-InputTimeout <Int32>] [-InternationalAccessCode <String>] [-InternationalNumberFormat <NumberFormat>] [-LogonFailuresBeforeDisconnect <Int32>] [-MatchedNameSelectionMethod <Title | Department | Location | None | PromptForAlias>] [-MaxCallDuration <Int32>] [-MaxRecordingDuration <Int32>] [-Name <String>] [-NationalNumberPrefix <String>] [-NDREnabled <$true | $false>] [-OperatorExtension <String>] [-OutsideLineAccessCode <String>] [-PromptPublishingPoint <String>] [-RecordingIdleTimeout <Int32>] [-SendVoiceMsgEnabled <$true | $false>] [-TUIPromptEditingEnabled <$true | $false>] [-UMAutoAttendant <UMAutoAttendantIdParameter>] [-VoIPSecurity <SIPSecured | Unsecured | Secured>] [-WelcomeGreetingEnabled <$true | $false>] [-WelcomeGreetingFilename <String>] [-WhatIf [<SwitchParameter>]]

Set-UMDialPlan [-AccessTelephoneNumbers <MultiValuedProperty>] [-AllowDialPlanSubscribers <$true | $false>] [-AllowedInCountryOrRegionGroups <MultiValuedProperty>] [-AllowedInternationalGroups <MultiValuedProperty>] [-AllowExtensions <$true | $false>] [-AudioCodec <G711 | Wma | Gsm>] [-AutomaticSpeechRecognitionEnabled <$true | $false>] [-CallSomeoneEnabled <$true | $false>] [-ConfiguredInCountryOrRegionGroups <MultiValuedProperty>] [-ConfiguredInternationalGroups <MultiValuedProperty>] [-Confirm [<SwitchParameter>]] [-ContactAddressList <AddressListIdParameter>] [-ContactRecipientContainer <OrganizationalUnitIdParameter>] [-ContactScope <DialPlan | GlobalAddressList | Extension | AutoAttendantLink | AddressList>] [-CountryOrRegionCode <String>] [-DefaultLanguage <UMLanguage>] [-DialByNamePrimary <LastFirst | FirstLast | SMTPAddress>] [-DialByNameSecondary <LastFirst | FirstLast | SMTPAddress | None>] [-DomainController <Fqdn>] [-EquivalenceDialPlan <Guid>] [-Extension <String>] [-FaxEnabled <$true | $false>] [-FDSPollingInterval <Int32>] [-InCountryOrRegionNumberFormat <NumberFormat>] [-InfoAnnouncementEnabled <True | False | Uninteruptible>] [-InfoAnnouncementFilename <String>] [-InputFailuresBeforeDisconnect <Int32>] [-InputRetries <Int32>] [-InputTimeout <Int32>] [-Instance <UMDialPlan>] [-InternationalAccessCode <String>] [-InternationalNumberFormat <NumberFormat>] [-LogonFailuresBeforeDisconnect <Int32>] [-MatchedNameSelectionMethod <Title | Department | Location | None | PromptForAlias>] [-MaxCallDuration <Int32>] [-MaxRecordingDuration <Int32>] [-Name <String>] [-NationalNumberPrefix <String>] [-NDREnabled <$true | $false>] [-OperatorExtension <String>] [-OutsideLineAccessCode <String>] [-PromptPublishingPoint <String>] [-RecordingIdleTimeout <Int32>] [-SendVoiceMsgEnabled <$true | $false>] [-TUIPromptEditingEnabled <$true | $false>] [-UMAutoAttendant <UMAutoAttendantIdParameter>] [-VoIPSecurity <SIPSecured | Unsecured | Secured>] [-WelcomeGreetingEnabled <$true | $false>] [-WelcomeGreetingFilename <String>] [-WhatIf [<SwitchParameter>]]

Подробное описание

Командлет Set-UMDialplan позволяет изменять настройки существующей абонентской группы единой системы обмена сообщениями. Некоторые свойства абонентской группы единой системы обмена сообщениями являются необходимыми и создаются по умолчанию. Однако в некоторых случаях после создания абонентской группы единой системы обмена сообщениями не все ее свойства могут быть перезаписаны. Поэтому некоторые свойства невозможно изменить, если не удалить существующую абонентскую группу единой системы обмена сообщениями и не создать ее снова.

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

Для выполнения командлета Set-UMDialplan используемой учетной записи необходимо делегировать роль администратора организации Exchange.

Дополнительные сведения о разрешениях, делегировании ролей и правах, необходимых для администрирования сервера Microsoft Exchange Server 2007, см. в разделе Вопросы, связанные с разрешениями.

Параметры

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

Identity

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

Microsoft.Exchange.Configuration.Tasks.UMDialPlanIdParameter

Этот параметр определяет код абонентской группы единой системы обмена сообщениями. Параметр является идентификатором объекта каталога для абонентской группы. Этот параметр используется для связи почтовых ящиков и серверов единой системы обмена сообщениями с абонентскими группами.

AccessTelephoneNumbers

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

Microsoft.Exchange.Data.MultiValuedProperty

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

AllowDialPlanSubscribers

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

System.Boolean

Этот параметр указывает, разрешено ли подписчикам абонентской группы набирать номера подписчиков той же абонентской группы. Значение по умолчанию: $true.

AllowedInCountryOrRegionGroups

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

Microsoft.Exchange.Data.MultiValuedProperty

Этот параметр задает список имен из одной абонентской группы внутри страны/региона, к которым есть доступ. Имя разрешенной группы внутри страны/региона должно соответствовать имени группы, указанному в абонентской группе единой системы обмена сообщениями.

AllowedInternationalGroups

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

Microsoft.Exchange.Data.MultiValuedProperty

Этот параметр задает список имен разрешенных международных абонентских групп. Имена международных абонентских групп, которые разрешено набирать абонентам, должны соответствовать именам групп, определенным в абонентской группе.

AllowExtensions

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

System.Boolean

Этот параметр указывает, следует ли разрешать вызовы расширений абонентской группы. Значение по умолчанию: $false.

AudioCodec

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

Microsoft.Exchange.Data.Directory.SystemConfiguration.AudioCodecEnum

Этот параметр определяет аудиокодек, используемый для записи. Настройка по умолчанию: WMA.

AutomaticSpeechRecognitionEnabled

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

System.Boolean

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

CallSomeoneEnabled

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

System.Boolean

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

ConfiguredInCountryOrRegionGroups

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

Microsoft.Exchange.Data.MultiValuedProperty

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

  • имя группы (до 32 знаков);

  • AllowedNumberString;

  • DialNumberString;

  • TextComment.

ConfiguredInternationalGroups

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

Microsoft.Exchange.Data.MultiValuedProperty

Этот параметр определяет международные группы, которые можно использовать. Каждая строка состоит из четырех частей:

  • имя группы (до 32 знаков);

  • AllowedNumberString;

  • DialNumberString;

  • TextComment.

Confirm

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

System.Management.Automation.SwitchParameter

Этот параметр используется для приостановки команды и требует, чтобы администратор подтвердил ее выполнение. По умолчанию этот параметр имеет значение «$true».

ContactAddressList

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

Microsoft.Exchange.Configuration.Tasks.AddressListIdParameter

Этот параметр указывает идентификатор списка адресов. Если для параметра ContactScope установлено значение AddressList, он определяет область поиска в каталоге.

ContactRecipientContainer

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

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

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

ContactScope

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

Microsoft.Exchange.Data.Directory.SystemConfiguration.CallSomeoneScopeEnum

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

CountryOrRegionCode

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

System.String

Этот параметр указывает код определенной страны/региона для данной страны/региона. Этот номер будет набран при звонке в определенную страну/регион. Например, 1 — это США.

DefaultLanguage

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

Microsoft.Exchange.Data.UMLanguage

Этот параметр указывает язык системы по умолчанию. Этот язык по умолчанию выбирается из списка доступных языков. Языком по умолчанию является «Английский (США)».

DialByNamePrimary

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

Microsoft.Exchange.Data.Directory.SystemConfiguration.DialByNamePrimaryEnum

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

DialByNameSecondary

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

Microsoft.Exchange.Data.Directory.SystemConfiguration.DialByNameSecondaryEnum

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

DomainController

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

Microsoft.Exchange.Data.Fqdn

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

EquivalenceDialPlan

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

System.Guid

Этот параметр указывает имя эквивалентной абонентской группы в другом лесе. Когда абонентская группа охватывает два леса и создается второй объект абонентской группы, GUID исходной абонентской группы копируется на адрес прокси-сервера пользователя в другом лесе.

Extension

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

System.String

Этот параметр указывает номер расширения, используемый в функции вызова кого-нибудь при переводе вызова.

FaxEnabled

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

System.Boolean

Этот параметр указывает, поддерживает ли система факсы. Сервер единой системы обмена сообщениями не будет загружать соответствующие компоненты, если абонентская группа не поддерживает факсы. Значение по умолчанию: $true.

FDSPollingInterval

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

System.Int32

Интервал в минутах между проверками на наличие новых данных службы рассылки файлов на пункте трансляции. Допустимый диапазон: от 1 до 1440 минут. По умолчанию используется значение 5 минут.

InCountryOrRegionNumberFormat

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

Microsoft.Exchange.Data.NumberFormat

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

InfoAnnouncementEnabled

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

Microsoft.Exchange.Data.Directory.SystemConfiguration.InfoAnnouncementEnabledEnum

Этот параметр указывает, разрешены ли информационные сообщения. Значения этого параметра могут равняться Enabled, Disabled или Uninterruptible. Значение по умолчанию: $true.

InfoAnnouncementFilename

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

System.String

Этот параметр указывает имя звукового файла для информационного сообщения.

InputFailuresBeforeDisconnect

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

System.Int32

Этот параметр указывает количество последующих разрешенных ошибок ввода пользователя, прежде чем вызов будет отключен. Значение по умолчанию: 3.

InputRetries

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

System.Int32

Этот параметр указывает количество повторений ввода, разрешенных абоненту, при истечении времени ожидания. Это применимо прошедшим проверку подлинности пользователям, а также пользователям, отвечающим на звонки, и пользователям с автосекретарем. Значение по умолчанию: 3.

InputTimeout

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

System.Int32

Этот параметр указывает время ожидания системой пользовательского ввода. Это ограничение времени применимо к прошедшим проверку подлинности пользователям, а также пользователям, отвечающим на звонки, и пользователям с автосекретарем. Значение по умолчанию: 5 секунд.

Instance

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

Microsoft.Exchange.Data.Directory.SystemConfiguration.UMDialPlan

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

InternationalAccessCode

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

System.String

Этот параметр указывает код, который предваряет телефонный номер, для международных вызовов. Например, 011 означает код вызова США.

InternationalNumberFormat

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

Microsoft.Exchange.Data.NumberFormat

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

LogonFailuresBeforeDisconnect

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

System.Int32

Этот параметр указывает количество последующих неудачных попыток входа в систему, прежде чем вызов будет отключен. Значение по умолчанию: 3.

MatchedNameSelectionMethod

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

Microsoft.Exchange.Data.Directory.SystemConfiguration.DisambiguationFieldEnum

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

  • Отдел

  • Должность

  • Место

  • Отсутствует

  • Запрос псевдонима

  • Наследуется из абонентской группы единой системы обмена сообщениями

MaxCallDuration

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

System.Int32

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

MaxRecordingDuration

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

System.Int32

Этот параметр указывает максимальную длину записи сообщений. Это относится ко всем видам звонков. Этот параметр может принимать значения от 5 до 100. Слишком маленькое значение может привести к отключению длительных голосовых сообщений перед их завершением. Слишком высокое значение этого параметра позволит пользователям сохранять длительные голосовые сообщения в своих папках «Входящие».

В пакете обновления 2 (SP2) для Exchange 2007 значение этого параметра может находиться в диапазоне от 1 до 100.

Name

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

System.String

Этот параметр определяет краткое имя для абонентской группы единой системы обмена сообщениями. Длина имени ограничена 64 знаками.

NationalNumberPrefix

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

System.String

Этот параметр указывает код, который предваряет телефонный номер для междугородних вызовов внутри страны. Например, 1 в Северной Америке.

NDREnabled

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

System.Boolean

Этот параметр указывает, будут ли сообщения ответа на звонки единой системы обмена сообщениями запрашивать отчеты о недоставке. Если этот параметр имеет значение $false, сообщения отправляются без запроса отчета о недоставке. Значение по умолчанию: $false.

OperatorExtension

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

System.String

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

OutsideLineAccessCode

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

System.String

Этот параметр указывает код, который предваряет телефонный номер для набора внешнего телефонного номера внутри страны/региона. Этот код также называется междугородным кодом. Значение по умолчанию: 9.

PromptPublishingPoint

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

System.String

Этот параметр указывает путь к общим папкам Microsoft Windows сервера и к общему ресурсу, где будут храниться настраиваемые приглашения. Местоположение по умолчанию — первый сервер единой системы обмена сообщениями при добавлении его к абонентской группе.

RecordingIdleTimeout

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

System.Int32

Этот параметр указывает продолжительность молчания абонента при записи голосового сообщения перед завершением записи. Значение по умолчанию: 5 секунд.

SendVoiceMsgEnabled

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

System.Boolean

Этот параметр указывает, включена ли функция отправки сообщения.

TUIPromptEditingEnabled

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

System.Boolean

Этот параметр указывает, разрешено ли авторизованным пользователям записывать абонентскую группу единой системы обмена сообщениями или приглашения автосекретаря с помощью телефонного интерфейса пользователя. Значение по умолчанию: $false.

UMAutoAttendant

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

Microsoft.Exchange.Configuration.Tasks.UMAutoAttendantIdParameter

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

VoIPSecurity

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

Microsoft.Exchange.Data.Directory.SystemConfiguration.UMVoIPSecurityType

От этого параметра зависит, будет ли данные по протоколу VoIP передаваться в незашифрованном виде или сигнальный канал либо сигнальный канал и канал данных будут шифроваться с использованием протокола MTLS (Mutual TLS). Значение по умолчанию — UnSecured.

WelcomeGreetingEnabled

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

System.Boolean

Этот параметр указывает, включено ли настраиваемое приветствие. Значение по умолчанию: $false.

WelcomeGreetingFilename

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

System.String

Этот параметр указывает имя звукового файла для приветствия.

WhatIf

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

System.Management.Automation.SwitchParameter

Этот параметр заставляет команду имитировать действия, которые она будет выполнять над объектом. С помощью параметра WhatIf администратор может просматривать изменения, которые могли бы произойти, без применения этих изменений. По умолчанию этот параметр имеет значение «$true».

Типы входных данных

Типы возвращаемых данных

Ошибки

Ошибка Описание

 

 

Исключения

Исключения Описание

 

 

Пример

В первом примере абонентская группа единой системы обмена сообщениями, названная «MyUMDialPlan», настраивается для использования добавочного номера 9 для доступа к внешней линии.

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

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

Set-UMDialPlan -Identity MyDialPlan -OutsideLineAccessCode 9

Set-UMDialPlan -Identity MyDialPlan -WelcomeGreetingEnabled $true -WelcomeGreetingFilename welcome.wav

$csv=import-csv "C:\MyInCountryGroups.csv"
Set-UMDialPlan -Identity MyDialPlan -ConfiguredInCountryGroups $csv
Set-UMDialPlan -Identity MyDialPlan -AllowedInCountryGroups "local, long distance"