Set-UMService

  • Ссылка
Модуль:
ExchangePowerShell
Применяется к:
Exchange Server 2013, Exchange Server 2016

Этот командлет доступен только в локальной среде Exchange.

Используйте командлет Set-UMService для изменения свойств службы единой системы обмена сообщениями Майкрософт Exchange на серверах почтовых ящиков Exchange 2013 или Exchange 2016.

Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.

Синтаксис

Set-UMService
   [-Identity] <UMServerIdParameter>
   [-Confirm]
   [-DialPlans <MultiValuedProperty>]
   [-DomainController <Fqdn>]
   [-GrammarGenerationSchedule <ScheduleInterval[]>]
   [-IPAddressFamily <IPAddressFamily>]
   [-IPAddressFamilyConfigurable <Boolean>]
   [-IrmLogEnabled <Boolean>]
   [-IrmLogMaxAge <EnhancedTimeSpan>]
   [-IrmLogMaxDirectorySize <Unlimited>]
   [-IrmLogMaxFileSize <ByteQuantifiedSize>]
   [-IrmLogPath <LocalLongFullPath>]
   [-MaxCallsAllowed <Int32>]
   [-SIPAccessService <ProtocolConnectionSettings>]
   [-Status <ServerStatus>]
   [-UMStartupMode <UMStartupMode>]
   [-WhatIf]
   [<CommonParameters>]

Описание

Для его запуска необходимо получить соответствующие разрешения. В этой статье перечислены все параметры командлета. Но некоторые из них могут быть вам не доступны, если они не включены в назначенные разрешения. Сведения о необходимых разрешениях для запуска командлетов и использования параметров в организации см. в статье Find the permissions required to run any Exchange cmdlet.

Примеры

Пример 1

Set-UMService -Identity MyUMServer -IPAddressFamily Any -UMStartupMode Dual

В этом примере выполняются следующие действия:

  • Позволяет службе единой системы обмена сообщениями Microsoft Exchange на сервере почтовых ящиков с именем MyUMServer принимать пакеты данных IPv6 и IPv4.
  • Позволяет службе единой системы обмена сообщениями Microsoft Exchange на сервере почтовых ящиков с именем MyUMServer запускаться в режиме TCP и TLS.

Пример 2

Set-UMService -Identity MyUMServer -DialPlans $null

В этом примере показано удаление сервера почтовых ящиков MyUMServer из всех абонентских групп единой системы обмена сообщениями.

Пример 3

Set-UMService -Identity MyUMServer -DialPlans MySIPDialPlan -MaxCallsAllowed 50 -SipAccessService northamerica.lyncpoolna.contoso.com:5061 -UMStartupMode TLS

В этом примере выполняются следующие действия:

  • Добавляет сервер почтовых ящиков единой системы обмена сообщениями с именем MyUMServer в абонентскую группу MySIPDialPlan.
  • Устанавливает максимальное количество входящих вызовов как 50.
  • Задает northamerica.lyncpoolna.contoso.com:5061 в качестве полного доменного имени и порта для службы доступа SIP, используемой Майкрософт Lync Server или Skype для бизнеса Server для входящих и исходящих вызовов с удаленных клиентов Lync или Skype для бизнеса.
  • Позволяет службе единой системы обмена сообщениями Microsoft Exchange на сервере почтовых ящиков с именем MyUMServer запускаться в режиме TLS.

Параметры

-Confirm

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

  • Деструктивные командлеты (например, командлеты Remove-*) имеют встроенную паузу, которая заставляет вас подтвердить команду перед продолжением. Можно пропускать запросы на подтверждение этих командлетов, используя следующий синтаксис: -Confirm:$false.
  • Большинство других командлетов (например, командлеты New-* и Set-*) не имеют встроенной приостановки. Для этих командлетов указание переключателя Confirm без значения вводит паузу, которая заставляет вас подтвердить команду перед продолжением.
Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016

-DialPlans

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

Серверы Exchange 2016 и Exchange 2013 не могут быть связаны с абонентской группой единой системы обмена сообщениями TelExt или E.164, но могут быть связаны или добавлены в абонентские группы SIP. Если вы интегрируете единую систему обмена сообщениями с Lync Server 2010, Lync Server 2013 или Skype для бизнеса Server 2015, необходимо связать или добавить все серверы Exchange 2016 и Exchange 2013 в абонентские группы SIP.

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

Чтобы ввести несколько значений и перезаписать все существующие записи, используйте следующий синтаксис: Value1,Value2,...ValueN. Если значения содержат пробелы или иным образом требуют кавычек, используйте следующий синтаксис: "Value1","Value2",..."ValueN".

Чтобы добавить или удалить одно или несколько значений, не затрагивая существующие записи, используйте следующий синтаксис: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016

-DomainController

Параметр DomainController указывает контроллер домена, который используется этим командлетом для чтения или записи данных в Active Directory. Вы определяете контроллер домена по его полному доменному имени (FQDN). Например, dc01.contoso.com.

Type:Fqdn
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016

-GrammarGenerationSchedule

Параметр GrammarGenerationSchedule указывает запланированные моменты времени для запуска процесса создания грамматик речи. Этот параметр позволяет использовать в течение дня только одно время начала. Запланированное время для создания грамматик по умолчанию: 02:00–02:30 по местному времени каждый день.

Синтаксис этого параметра: StartDay.Hour:Minute [AM | PM]-EndDay.Hour:Minute [AM | PM]. Можно указать несколько расписаний, разделенных запятыми: "Schedule1","Schedule2",..."ScheduleN".

Для дней можно использовать следующие значения:

  • Полное название дня.
  • Сокращенное название дня.
  • Целое число от 0 до 6, где 0 = воскресенье.

Вы можете ввести время в формате 24 часа и опустить значение AM/PM. Если ввести время в формате 12 часов, укажите пробел между временем и значением AM/PM.

Вы можете сочетать и сопоставлять форматы даты и времени.

Промежуток между временем начала и временем окончания должен составлять не менее 15 минут. Число минут округляется до значений 0, 15, 30 и 45. При указании нескольких интервалов промежутки между ними должны составлять не менее 15 минут.

Ниже приводятся примеры:

  • "Sun.11:30 PM-Mon.1:30 AM"
  • "6.22:00-6.22:15" (Работает с субботы в 22:00 по субботу в 22:15.
  • "Вс.1:15-понедельник.23:00"
  • "Понедельник.4:30-Понедельник.5:30","Среда.4:30 AM-Среда.5:30 AM" (Работает в понедельник и среду утром с 4:30 до 5:30.)
Type:ScheduleInterval[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016

-Identity

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

  • имя;
  • различающееся имя (DN);
  • ExchangeLegacyDN
  • GUID
Type:UMServerIdParameter
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016

-IPAddressFamily

Параметр IPAddressFamily определяет, будет ли шлюз IP единой системы обмена сообщениями использовать для связи IPv4, IPv6 или оба эти протокола. Допустимые значения:

  • IPv4
  • IPv6
  • Любой: IPv6 используется в первую очередь, и при необходимости IP-шлюз единой системы обмена сообщениями возвращается к IPv4. Это значение используется по умолчанию.
Type:IPAddressFamily
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016

-IPAddressFamilyConfigurable

Параметр IPAddressFamilyConfigurable указывает, можно ли задать параметр IPAddressFamily равным IPv6Only или Any. Значение по умолчанию — $true.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016

-IrmLogEnabled

Параметр IrmLogEnabled указывает, включено ли ведение журнала транзакций управления правами на доступ к данным (IRM). По умолчанию ведение журналов управления правами на доступ к данным включено. Допустимые значения:

  • $true: включение ведения журнала IRM
  • $false. Отключение ведения журнала IRM
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016

-IrmLogMaxAge

Параметр IrmLogMaxAge указывает максимальный срок хранения файла журнала IRM. Файлы журнала, время хранения которых превышает указанное значение, удаляются. Значение по умолчанию — 30 дней.

Чтобы указать значение, введите его как период времени: dd.hh:mm:ss (dd — дни, hh — часы, mm — минуты и ss — секунды).

Допустимый диапазон вводимых значений для этого параметра: от 00:00:00 до 24855.03:14:07. Установка значения 00:00:00 для параметра IrmLogMaxAge препятствует автоматическому удалению файлов журнала IRM при достижении максимального значения срока хранения.

Type:EnhancedTimeSpan
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016

-IrmLogMaxDirectorySize

Параметр IrmLogMaxDirectorySize указывает максимальный размер всех журналов IRM в каталоге журналов подключений. Когда размер каталога достигает максимального значения, сервер в первую очередь удаляет самые старые файлы. Значение по умолчанию: 250 мегабайт (МБ).

Допустимое значение — число до 1,999999999 ТБ (2 199 023 254 528 Б) или значение unlimited. Значение по умолчанию — 6 ГБ (6 442 450 944 Б).

  • Б (байт)
  • КБ (килобайт)
  • МБ (мегабайт)
  • ГБ (гигабайты)
  • ТБ (терабайт)

TB (терабайт)

Значение параметра IrmLogMaxFileSize должно быть меньше или равно значению, указанному в параметре IrmLogMaxDirectorySize. Допустимый диапазон вводимых значений для любого из этих параметров — от 1 до 9 223 372 036 854 775 807 байт. Если ввести значение unlimited, никакие ограничения на размер каталога журналов подключений налагаться не будут.

Type:Unlimited
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016

-IrmLogMaxFileSize

Параметр IrmLogMaxFileSize указывает максимальный размер каждого файла журнала IRM. Когда размер файла журнала достигает максимального значения, создается новый файл журнала. Значение по умолчанию — 10 МБ.

Допустимое значение — число до 1,999999999 ТБ (2 199 023 254 528 Б) или значение unlimited. Значение по умолчанию — 6 ГБ (6 442 450 944 Б).

  • Б (байт)
  • КБ (килобайт)
  • МБ (мегабайт)
  • ГБ (гигабайты)
  • ТБ (терабайт)

TB (терабайт)

Значение параметра IrmLogMaxFileSize должно быть меньше или равно значению, указанному в параметре IrmLogMaxDirectorySize. Допустимый диапазон вводимых значений для любого из этих параметров — от 1 до 9 223 372 036 854 775 807 байт. Если ввести значение unlimited, никакие ограничения на размер файлов журналов IRM налагаться не будут.

Type:ByteQuantifiedSize
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016

-IrmLogPath

Параметр IrmLogPath указывает каталог, где находится журнал IRM по умолчанию. Расположение по умолчанию: %ExchangeInstallPath%IRMLogs.

Если для этого параметра установлено значение $null, то ведение журнала IRM фактически отключается. Однако если задать для этого параметра значение $null, если значение параметра IrmLogEnabled $true, в журнале событий приложения возникают ошибки. Предпочтительный способ отключения ведения журнала IRM — задание параметру IrmLogEnabled значения $false.

Type:LocalLongFullPath
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016

-MaxCallsAllowed

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

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016

-SIPAccessService

Параметр SIPAccessService указывает полное доменное имя и TCP-порт ближайшего переднего пула Lync Server или расположения переднего пула Skype для бизнеса Server для входящих и исходящих вызовов от удаленных пользователей Lync или Skype для бизнеса, расположенных за пределами сети.

Рекомендуется всегда использовать этот параметр в Lync Server или Skype для бизнеса Server развертываниях, охватывающих несколько географических регионов. В противном случае служба единой системы обмена сообщениями Майкрософт Exchange может выбрать пул для трафика мультимедиа Real-Time транспортного протокола (RTP), который не является ближайшим географически к удаленному пользователю.

Этот параметр настраивается для каждого экземпляра службы единой системы обмена сообщениями (каждый сервер Exchange), чтобы значение идентифицировало ближайший пул переднего плана Lync Server или Skype для бизнеса Server пул переднего плана к серверу Exchange Server.

Type:ProtocolConnectionSettings
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016

-Status

Этот параметр устарел и больше не используется.

Type:ServerStatus
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016

-UMStartupMode

Параметр UMStartupMode указывает режим запуска службы единой системы обмена сообщениями. Допустимые значения:

  • TCP (это значение по умолчанию)
  • TLS;
  • Двойной. Служба может прослушивать порты 5060 и 5061 одновременно. При добавлении Exchange Server в абонентские группы единой системы обмена сообщениями с другими параметрами безопасности следует использовать это значение.

Если изменить значение этого параметра, необходимо перезапустить службу единой системы обмена сообщениями.

Type:UMStartupMode
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016

-WhatIf

Переключатель WhatIf имитирует действия команды. Вы можете использовать его для просмотра результатов изменений без фактического внесения этих изменений. С этим параметром не нужно указывать значение.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016

Входные данные

Input types

Сведения о типах входных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип ввода для командлета пустое, командлет не принимает входные данные.

Выходные данные

Output types

Сведения о типах возвращаемых данных, которые также называются типами выходных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип вывода пусто, командлет не возвращает данные.