Set-UmServer

Этот командлет доступен только в Exchange Server 2010 г.

Используйте командлет Set-UMServer для изменения параметров, связанных с ролью сервера единой системы обмена сообщениями (UM).

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

Синтаксис

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

Описание

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

После выполнения этой задачи командлет устанавливает параметры и указанные значения.

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

Примеры

Пример 1

Set-UMServer -Identity MyUMServer -Status NoNewCalls

В этом примере сервер единой системы обмена сообщениями MyUMServer не может принимать новые вызовы.

Пример 2

Set-UMServer -Identity MyUMServer -DialPlans $null

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

Пример 3

Set-UMServer -Identity MyUMServer -DialPlans MyUMDialPlanName -MaxCallsAllowed 50

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

Пример 4

Set-UMServer -Identity MyUMServer -GrammarGenerationSchedule 0.02:30-1.03:00,1.02:30-1.03:00,2.02:30-2.03:00,3.02:30-3.03:00,4.02:30-4.03:00,5.02:30-5.03:00,6.02:30-6.03:00

В этом примере расписание создания грамматики изменяется на 02:30–03:00 каждый день на сервере единой системы обмена сообщениями MyUMServer.

Параметры

-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 2010

-DialPlans

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

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

-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 2010

-ExternalServiceFqdn

Параметр ExternalServiceFqdn — это полное доменное имя или имя узла подсистемы балансировки нагрузки, обслуживающей серверы единой системы обмена сообщениями. Этот параметр полезен при переносе серверов единой системы обмена сообщениями из организации в размещенную среду Microsoft Exchange Server 2010. Полное доменное имя узла внешней службы может содержать до 2048 символов.

Type:UMSmartHost
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-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 2010

-Identity

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

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

-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 2010

-IrmLogMaxAge

Параметр IrmLogMaxAge указывает максимальный срок хранения файла журнала IRM. Файлы журнала, время хранения которых превышает указанное значение, удаляются. Значение по умолчанию — 30 дней. Чтобы указать значение, введите значение в качестве интервала времени: dd.hh:mm:ss, где d = days, h = hours, m = minutes, and s = секунды. Допустимый диапазон вводимых значений для этого параметра: от 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 2010

-IrmLogMaxDirectorySize

Параметр IrmLogMaxDirectorySize указывает максимальный размер всех журналов IRM в каталоге журналов подключений. Когда размер каталога достигает максимального значения, сервер в первую очередь удаляет самые старые файлы. Значение по умолчанию: 250 мегабайт (МБ). Допустимое значение — число до 1,999999999 ТБ (2 199 023 254 528 Б) или значение unlimited. Значение по умолчанию — 6 ГБ (6 442 450 944 Б).

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

Значение без указания единицы измерения обрабатывается как количество байтов. Значение параметра 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 2010

-IrmLogMaxFileSize

Параметр IrmLogMaxFileSize указывает максимальный размер каждого файла журнала IRM. Когда размер файла журнала достигает максимального значения, создается новый файл журнала. Значение по умолчанию — 10 МБ. Допустимое значение — число до 1,999999999 ТБ (2 199 023 254 528 Б) или значение unlimited. Значение по умолчанию — 6 ГБ (6 442 450 944 Б).

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

Значение без указания единицы измерения обрабатывается как количество байтов. Значение параметра 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 2010

-IrmLogPath

Параметр IrmLogPath указывает каталог, где находится журнал IRM по умолчанию. Значение по умолчанию — C:\Program Files\Майкрософт\Exchange Server\V14. Если для параметра IrmLogPath установлено значение $null, то ведение журнала IRM фактически отключается. Однако если задать для параметра IrmLogPath значение $null, когда значение атрибута IrmLogEnabled $true, Exchange зановит ошибки в журнал событий приложения. Для отключения ведения журнала IRM рекомендуется задать для параметра IrmLogEnabled значение $false.

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

-MaxCallsAllowed

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

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

-SIPAccessService

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

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

Этот параметр настраивается для каждого сервера единой системы обмена сообщениями, чтобы значение определило ближайший пограничный пул 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 2010

-SipTcpListeningPort

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

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

-SipTlsListeningPort

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

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

-Status

Параметр Status указывает состояние сервера единой системы обмена сообщениями. Доступные параметры: Включено, Отключено и NoNewCalls.

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

-UMStartupMode

Параметр UMStartupMode указывает, будет ли служба единой системы обмена сообщениями Майкрософт Exchange на сервере единой системы обмена сообщениями запускаться в режиме TCP, TLS или Двойной. Если сервер единой системы обмена сообщениями добавляется в абонентские группы единой системы обмена сообщениями с другими параметрами безопасности, следует выбрать двойной режим. В двойном режиме сервер единой системы обмена сообщениями может прослушивать порты 5060 и 5061 одновременно. Если режим запуска изменен, необходимо перезапустить службу единой системы обмена сообщениями Майкрософт Exchange.

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

-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 2010

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

Input types

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

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

Output types

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