Set-UMService
Этот командлет доступен только в локальной среде Exchange.
Используйте командлет Set-UMService для изменения свойств службы единой системы обмена сообщениями Microsoft Exchange на серверах почтовых ящиков Exchange 2013 или Exchange 2016.
Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.
Синтаксис
Default (По умолчанию)
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, используемой Microsoft Lync Server или Skype для бизнеса Server для входящих и исходящих вызовов с удаленных клиентов Lync или Skype для бизнеса.
- Позволяет службе единой системы обмена сообщениями Microsoft Exchange на сервере почтовых ящиков с именем MyUMServer запускаться в режиме TLS.
Параметры
-Confirm
Применимо: Exchange Server 2013 г., Exchange Server 2016 г.
Переключатель подтверждения указывает, показывать или скрывать запрос подтверждения. Влияние этого параметра на командлет зависит от того, требуется ли для этого командлета подтверждение перед продолжением.
- Деструктивные командлеты (например, командлеты Remove-) имеют встроенную паузу, которая заставляет вас подтвердить команду перед продолжением. Можно пропускать запросы на подтверждение этих командлетов, используя следующий синтаксис:
-Confirm:$false. - Большинство других командлетов (например, командлеты New- и Set-) не имеют встроенной паузы. Для этих командлетов указание параметра Подтвердить без значения приводит к приостановке, которая заставляет подтвердить команду перед продолжением.
Свойства параметров
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | Cf |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-DialPlans
Применимо: Exchange Server 2013 г., Exchange Server 2016 г.
Параметр 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"...}.
Свойства параметров
| Тип: | MultiValuedProperty |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-DomainController
Применимо: Exchange Server 2013 г., Exchange Server 2016 г.
Параметр DomainController указывает контроллер домена, который используется этим командлетом для чтения или записи данных в Active Directory. Вы определяете контроллер домена по его полному доменному имени (FQDN). Например, dc01.contoso.com.
Свойства параметров
| Тип: | Fqdn |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-GrammarGenerationSchedule
Применимо: Exchange Server 2013 г., Exchange Server 2016 г.
Параметр 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.)
Свойства параметров
| Тип: | ScheduleInterval[] |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Identity
Применимо: Exchange Server 2013 г., Exchange Server 2016 г.
Параметр Identity указывает сервер почтовых ящиков, на котором размещена конфигурация службы единой системы обмена сообщениями, которую требуется изменить. Можно использовать любое значение, однозначно определяющее сервер. Примеры:
- имя;
- различающееся имя (DN);
- ExchangeLegacyDN
- GUID
Свойства параметров
| Тип: | UMServerIdParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | 1 |
| Обязательно: | True |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-IPAddressFamily
Применимо: Exchange Server 2013 г., Exchange Server 2016 г.
Параметр IPAddressFamily указывает используемую версию протокола IP. Допустимые значения:
- IPv4Only. IP-шлюз единой системы обмена сообщениями использует только IPv4 для обмена данными.
- IPv6Only: IP-шлюз единой системы обмена сообщениями использует только IPv6.
- Любой: IPv6 используется в первую очередь. Если IPv6 недоступен, используется IPV4. Это значение является значением по умолчанию.
Свойства параметров
| Тип: | IPAddressFamily |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-IPAddressFamilyConfigurable
Применимо: Exchange Server 2013 г., Exchange Server 2016 г.
Параметр IPAddressFamilyConfigurable указывает, можно ли задать параметр IPAddressFamily равным IPv6Only или Any. Значение по умолчанию — $true.
Свойства параметров
| Тип: | Boolean |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-IrmLogEnabled
Применимо: Exchange Server 2013 г., Exchange Server 2016 г.
Параметр IrmLogEnabled указывает, включено ли ведение журнала транзакций управления правами на доступ к данным (IRM). По умолчанию ведение журналов управления правами на доступ к данным включено. Допустимые значения:
- $true: включение ведения журнала IRM
- $false. Отключение ведения журнала IRM
Свойства параметров
| Тип: | Boolean |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-IrmLogMaxAge
Применимо: Exchange Server 2013 г., Exchange Server 2016 г.
Параметр IrmLogMaxAge указывает максимальный срок хранения файла журнала IRM. Файлы журнала, время хранения которых превышает указанное значение, удаляются. Значение по умолчанию — 30 дней.
Чтобы указать значение, введите его как период времени: dd.hh:mm:ss (dd — дни, hh — часы, mm — минуты и ss — секунды).
Допустимый диапазон вводимых значений для этого параметра: от 00:00:00 до 24855.03:14:07. Установка значения 00:00:00 для параметра IrmLogMaxAge препятствует автоматическому удалению файлов журнала IRM при достижении максимального значения срока хранения.
Свойства параметров
| Тип: | EnhancedTimeSpan |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-IrmLogMaxDirectorySize
Применимо: Exchange Server 2013 г., Exchange Server 2016 г.
Параметр 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, никакие ограничения на размер каталога журналов подключений налагаться не будут.
Свойства параметров
| Тип: | Unlimited |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-IrmLogMaxFileSize
Применимо: Exchange Server 2013 г., Exchange Server 2016 г.
Параметр 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 налагаться не будут.
Свойства параметров
| Тип: | ByteQuantifiedSize |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-IrmLogPath
Применимо: Exchange Server 2013 г., Exchange Server 2016 г.
Параметр IrmLogPath указывает каталог, где находится журнал IRM по умолчанию. Расположение по умолчанию: %ExchangeInstallPath%IRMLogs.
Если для этого параметра установлено значение $null, то ведение журнала IRM фактически отключается. Однако если значение параметра IrmLogEnabled равно $true, Exchange добавляет ошибки в журнал событий приложений. Предпочтительный способ отключения ведения журнала IRM — задание параметру IrmLogEnabled значения $false.
Свойства параметров
| Тип: | LocalLongFullPath |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-MaxCallsAllowed
Применимо: Exchange Server 2013 г., Exchange Server 2016 г.
Параметр MaxCallsAllowed указывает максимальное число одновременных голосовых вызовов, допускаемых службой единой системы обмена сообщениями. Значение по умолчанию — 100.
Свойства параметров
| Тип: | Int32 |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-SIPAccessService
Применимо: Exchange Server 2013 г., Exchange Server 2016 г.
Параметр SIPAccessService указывает полное доменное имя и TCP-порт ближайшего переднего пула Lync Server или расположения переднего пула Skype для бизнеса Server для входящих и исходящих вызовов от удаленных пользователей Lync или Skype для бизнеса, расположенных за пределами сети.
Рекомендуется всегда использовать этот параметр в Lync Server или Skype для бизнеса Server развертываниях, охватывающих несколько географических регионов. В противном случае служба единой системы обмена сообщениями Microsoft Exchange может выбрать пул для трафика мультимедиа Real-Time транспортного протокола (RTP), который не является ближайшим географически к удаленному пользователю.
Этот параметр настраивается для каждого экземпляра службы единой системы обмена сообщениями (каждый сервер Exchange), чтобы значение идентифицировало ближайший пул переднего плана Lync Server или Skype для бизнеса Server пул переднего плана к серверу Exchange Server.
Свойства параметров
| Тип: | ProtocolConnectionSettings |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Status
Применимо: Exchange Server 2013 г., Exchange Server 2016 г.
Этот параметр не рекомендуется использовать и больше не используется.
Свойства параметров
| Тип: | ServerStatus |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-UMStartupMode
Применимо: Exchange Server 2013 г., Exchange Server 2016 г.
Параметр UMStartupMode указывает режим запуска службы единой системы обмена сообщениями. Допустимые значения:
- TCP (значение по умолчанию)
- TLS;
- Двойной. Служба может прослушивать порты 5060 и 5061 одновременно. При добавлении Exchange Server в абонентские группы единой системы обмена сообщениями с другими параметрами безопасности следует использовать это значение.
Если изменить значение этого параметра, необходимо перезапустить службу единой системы обмена сообщениями.
Свойства параметров
| Тип: | UMStartupMode |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-WhatIf
Применимо: Exchange Server 2013 г., Exchange Server 2016 г.
Параметр WhatIf показывает, что выполняет команда, не внося никаких изменений. С этим параметром не нужно указывать значение.
Свойства параметров
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | Wi |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
CommonParameters
Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в статье about_CommonParameters.
Входные данные
Input types
Чтобы просмотреть типы входных данных, которые принимает этот командлет, см. Типы входных и выходных данных командлета. Если поле "Типы входных данных" для командлета пусто, командлет не принимает входные данные.
Выходные данные
Output types
Чтобы просмотреть типы возвращаемых данных, также называемые типами вывода, которые принимает этот командлет, см. раздел Типы ввода и вывода командлета. Если поле "Типы выходных данных" пусто, командлет не возвращает данные.