通过

Set-UMService

模块:
Exchange PowerShell

此 cmdlet 仅适用于本地 Exchange。

使用 Set-UMService cmdlet 修改 Exchange 2013 或 Exchange 2016 邮箱服务器上的 Microsoft Exchange 统一消息服务的属性。

有关以下语法部分的参数设置的详细信息，请参阅 Exchange cmdlet 语法。

语法

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

说明

您必须先获得权限，然后才能运行此 cmdlet。 尽管本文列出了 cmdlet 的所有参数，但如果某些参数未包含在分配给你的权限中，则可能无法访问这些参数。 若要查找在贵组织中运行任何 cmdlet 或参数所需的权限，请参阅 Find the permissions required to run any Exchange cmdlet。

示例

示例 1

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

本示例执行以下操作：

  • 在邮箱服务器 MyUMServer 上启用 Microsoft Exchange 统一消息服务以接受 IPv4 和 IPv6 数据包。
  • 在邮箱服务器 MyUMServer 上启用 Microsoft Exchange 统一消息服务以便使用 TCP 和 TLS 模式启动。

示例 2

Set-UMService -Identity MyUMServer -DialPlans $null

此示例从所有 UM 拨号计划中删除了邮箱服务器 MyUMServer。

示例 3

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

本示例执行以下操作：

  • 将邮箱服务器 MyUMServer 添加到 UM 拨号计划 MySIPDialPlan。
  • 将最大传入呼叫数设置为 50。
  • 将 northamerica.lyncpoolna.contoso.com:5061 设置为 sip 访问服务的 FQDN 和端口，Microsoft Lync Server 或 Skype for Business Server用于从远程 Lync 或 Skype for Business 客户端进行入站和出站呼叫。
  • 在邮箱服务器 MyUMServer 上启用 Microsoft Exchange 统一消息服务以便使用 TLS 模式启动。

参数

-Confirm

适用：2013 Exchange Server、Exchange Server 2016

Confirm 开关指定是否显示确认提示。 此开关对 cmdlet 造成的影响取决于在你继续操作之前 cmdlet 是否需要确认。

  • 破坏性 cmdlet（例如 Remove-* cmdlets）内置有暂停，可强制要求先确认命令，然后再继续操作。 对于这些 cmdlet，您可以使用此确切语法跳过确认提示：-Confirm:$false。
  • 其他大多数 cmdlet（例如 New-* 和 Set-* cmdlet）都没有内置暂停。 对于这些 cmdlet，指定不含值的 Confirm 开关会引入暂停，从而强制要求你先确认命令，然后再继续操作。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False
别名:cf

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-DialPlans

适用：2013 Exchange Server、Exchange Server 2016

DialPlans 参数指定统一消息服务处理传入呼叫的所有拨号计划。

Exchange 2016 和 Exchange 2013 服务器不能与 TelExt 或 E.164 UM 拨号计划相关联，但可以关联或添加到 SIP 拨号计划。 如果要将统一消息与 Lync Server 2010、Lync Server 2013 或 Skype for Business Server 2015 集成，则需要将所有 Exchange 2016 和 Exchange 2013 服务器关联或添加到 SIP 拨号计划。

还可以使用此参数将 Exchange 2010 统一消息服务器关联到 UM 拨号计划。

若要输入多个值并覆盖任何现有条目，请使用以下语法： Value1,Value2,...ValueN。 如果值中有空格或需要使用双引号，请使用以下语法："Value1","Value2",..."ValueN"。

要添加或移除一个或多个值而不影响任何现有条目，可使用以下语法: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.

参数属性

类型:MultiValuedProperty
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-DomainController

适用：2013 Exchange Server、Exchange Server 2016

DomainController 参数指定此 cmdlet 从 Active Directory 读取数据或向其写入数据时使用的域控制器。 可以使用完全限定的域名 (FQDN) 来标识域控制器。 例如，dc01.contoso.com。

参数属性

类型:Fqdn
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-GrammarGenerationSchedule

适用：2013 Exchange Server、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” (从周六晚上 10：00 运行到周六晚上 10：15.)
  • “星期日 1：15 AM-monday.23：00”
  • “Monday.4：30 AM-monday.5：30 AM”，“wednesday.4：30 AM-wednesday.5：30 AM” (从周一和周三早上的 4：30 运行到 5：30.)

参数属性

类型:

ScheduleInterval[]

默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-Identity

适用：2013 Exchange Server、Exchange Server 2016

Identity 参数指定托管要修改的统一消息服务配置的邮箱服务器。 可以使用唯一标识该服务器的任何值。 例如：

  • 名称
  • 可分辨名称 (DN)
  • ExchangeLegacyDN
  • GUID

参数属性

类型:UMServerIdParameter
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:1
必需:True
来自管道的值:True
来自管道的值（按属性名称）:True
来自剩余参数的值:False

-IPAddressFamily

适用：2013 Exchange Server、Exchange Server 2016

IPAddressFamily 参数指定要使用的 Internet 协议 (IP) 版本。 有效值包含:

  • IPv4Only：UM IP 网关仅使用 IPv4 进行通信。
  • IPv6Only：UM IP 网关仅使用 IPv6。
  • 任何：首先使用 IPv6。 如果 IPv6 不可用，则使用 IPV4。 此值为默认值。

参数属性

类型:IPAddressFamily
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-IPAddressFamilyConfigurable

适用：2013 Exchange Server、Exchange Server 2016

IPAddressFamilyConfigurable 参数指定您是否能够设置 IPAddressFamily 参数为 IPv6Only 或 Any。 默认值为 True。

参数属性

类型:Boolean
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-IrmLogEnabled

适用：2013 Exchange Server、Exchange Server 2016

IrmLogEnabled 参数指定是否启用信息权限管理 (IRM) 事务的日志记录。 默认情况下会启用 IRM 日志记录。 有效值包含:

  • $true：启用 IRM 日志记录
  • $false：禁用 IRM 日志记录

参数属性

类型:Boolean
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-IrmLogMaxAge

适用：2013 Exchange Server、Exchange Server 2016

IrmLogMaxAge 参数指定 IRM 日志文件的最长期限。 早于指定值的日志文件将被删除。 默认值为 30 天。

若要指定值，请以时间跨度格式 dd.hh:mm:ss 输入值（其中 dd = 天，hh = 小时，mm = 分钟，ss = 秒）。

此参数的有效输入范围是 00:00:00 到 24855.03:14:07。 将 IrmLogMaxAge 参数的值设置为 00:00:00，可以防止由于期限问题而自动删除 IRM 日志文件。

参数属性

类型:EnhancedTimeSpan
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-IrmLogMaxDirectorySize

适用：2013 Exchange Server、Exchange Server 2016

IrmLogMaxDirectorySize 参数指定连接日志目录中的所有 IRM 日志的最大大小。 当目录达到其最大文件大小时，服务器会首先删除最早的日志文件。 默认值为 250 MB。

有效值是一个数字，最大可为 1.999999999 TB（即 2199023254528 B）或值 unlimited。默认值为 6 GB（即 6442450944 B）。

  • B（字节）
  • KB（千字节）
  • MB（兆字节）
  • GB（千兆字节）
  • TB（兆兆字节）

非限定值通常被视为字节，但小值可能会向上舍入到最接近的千字节。

IrmLogMaxFileSize 参数的值必须小于或等于 IrmLogMaxDirectorySize 参数的值。 这两个参数的有效输入范围都是从 1 到 9223372036854775807 字节。 如果输入值 unlimited，则对连接日志目录没有大小限制。

参数属性

类型:Unlimited
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-IrmLogMaxFileSize

适用：2013 Exchange Server、Exchange Server 2016

IrmLogMaxFileSize 参数指定每个 IRM 日志文件的最大大小。 当日志文件达到其最大文件大小时，将创建新的日志文件。 默认值为 10 MB。

有效值是一个数字，最大可为 1.999999999 TB（即 2199023254528 B）或值 unlimited。默认值为 6 GB（即 6442450944 B）。

  • B（字节）
  • KB（千字节）
  • MB（兆字节）
  • GB（千兆字节）
  • TB（兆兆字节）

非限定值通常被视为字节，但小值可能会向上舍入到最接近的千字节。

IrmLogMaxFileSize 参数的值必须小于或等于 IrmLogMaxDirectorySize 参数的值。 这两个参数的有效输入范围都是从 1 到 9223372036854775807 字节。 如果输入值 unlimited，则对 IRM 日志文件没有大小限制。

参数属性

类型:ByteQuantifiedSize
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-IrmLogPath

适用：2013 Exchange Server、Exchange Server 2016

IrmLogPath 参数指定默认的 IRM 日志目录位置。 默认位置为 %ExchangeInstallPath%IRMLogs。

如果将此参数值设置为 $null，将有效地禁用 IRM 日志记录。 但是，如果 IrmLogEnabled 参数的值$true，则 Exchange 会将错误添加到应用程序事件日志。 禁用 IRM 日志记录的首选方法是将 IrmLogEnabled 参数设置为 $false。

参数属性

类型:LocalLongFullPath
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-MaxCallsAllowed

适用：2013 Exchange Server、Exchange Server 2016

MaxCallsAllowed 参数指定统一消息服务允许的最大并发语音呼叫数。 默认值为 100。

参数属性

类型:Int32
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-SIPAccessService

适用：2013 Exchange Server、Exchange Server 2016

SIPAccessService 参数指定最近的 Lync Server 前端池的 FQDN 和 TCP 端口，或者Skype for Business Server前端池位置，以便从远程 Lync 或网络外部Skype for Business用户进行入站和出站呼叫。

建议始终在 Lync Server 或跨多个地理区域的Skype for Business Server部署中使用此参数;否则，Microsoft Exchange 统一消息服务可能会选择一个池来 Real-Time 传输协议 (RTP) 媒体流量，该流量在地理上不是最靠近远程用户的媒体流量。

为统一消息服务的每个实例配置此参数， (每个 Exchange 服务器) 以便该值标识离 Exchange 服务器最近的 Lync Server 前端池或Skype for Business Server前端池。

参数属性

类型:ProtocolConnectionSettings
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-Status

适用：2013 Exchange Server、Exchange Server 2016

此参数已弃用，不再使用。

参数属性

类型:ServerStatus
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-UMStartupMode

适用：2013 Exchange Server、Exchange Server 2016

UMStartupMode 参数指定统一消息服务的启动模式。 有效值包含:

  • TCP (默认值)
  • TLS
  • 双重：服务可以同时侦听端口 5060 和 5061。 如果将 Exchange 服务器添加到具有不同安全设置的 UM 拨号计划，则应使用此值。

如果更改此参数的值，您需要重启统一消息服务。

参数属性

类型:UMStartupMode
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-WhatIf

适用：2013 Exchange Server、Exchange Server 2016

WhatIf 开关模拟命令操作。 可以使用此开关在不实际应用将会发生的更改的情况下预览这些更改。 不必为此开关指定值。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False
别名:无线

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

CommonParameters

此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。

输入

Input types

若要了解此 cmdlet 接受的输入类型，请参阅 cmdlet 的输入和输出类型。 如果 cmdlet 的"输入类型"字段为空，则表明此 cmdlet 不接受输入数据。

输出

Output types

若要了解此 cmdlet 接受的返回类型（亦称为"输出类型"），请参阅 cmdlet 的输入和输出类型。 如果"输出类型"字段为空，则表明此 cmdlet 不返回任何数据。