Командлет Set-UMDialplan (окончательная первоначальная версия)

  • Статья

 

Применимо к: Exchange Server 2007

Последнее изменение раздела: 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>] [-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>] [-WelcomeGreetingEnabled <$true | $false>] [-WelcomeGreetingFilename <String>]

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>] [-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>] [-WelcomeGreetingEnabled <$true | $false>] [-WelcomeGreetingFilename <String>]

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

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

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

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

  • роль администратора организации Exchange.

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

Параметры

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

Идентификатор

Обязательность

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.

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, включите в командлет параметр DomainController.

EquivalenceDialPlan

Дополнительно

System.Guid

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

Добавочный номер

Дополнительно

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

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

  • Отдел

  • Название

  • Место

  • None (нет)

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

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

MaxCallDuration

Дополнительно

System.Int32

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

MaxRecordingDuration

Дополнительно

System.Int32

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

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

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

Имя

Дополнительно

System.String

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

NationalNumberPrefix

Дополнительно

System.String

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

NDREnabled

Дополнительно

System.Boolean

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

OperatorExtension

Дополнительно

System.String

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

OutsideLineAccessCode

Дополнительно

System.String

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

PromptPublishingPoint

Дополнительно

System.String

Этот параметр указывает путь к общим папкам 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

Этот параметр указывает, шифруется ли сигнальный канал с помощью MTLS. Настройка по умолчанию — UnSecured.

WelcomeGreetingEnabled

Дополнительно

System.Boolean

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

WelcomeGreetingFilename

Дополнительно

System.String

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

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

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

Ошибки

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

 

 

Исключения

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

 

 

Пример

В первом примере абонентская группа единой системы обмена сообщениями, названная «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"