Set-UMService

參考

模組:: ExchangePowerShell

適用於:: Exchange Server 2013, Exchange Server 2016

內部部署 Exchange 才有提供此 Cmdlet。

使用 Set-UMService Cmdlet 修改 Exchange 2013 或 Exchange 2016 信箱伺服器上Microsoft Exchange Unified Messaging 服務的屬性。

如需下方＜語法＞一節中參數集的詳細資訊，請參閱 Exchange Cmdlet 語法。

Syntax

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

Description

您必須已獲指派權限，才能執行此指令程式。雖然本主題已列出這個指令程式的所有參數，不過，如果某些參數並未包含在指派給您的權限中，您可能就無法存取這些參數。若要尋找在組織中執行任何 Cmdlet 或參數所需的權限，請參閱 Find the permissions required to run any Exchange cmdlet。

範例

範例 1

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

本範例執行下列動作：

讓信箱伺服器 MyUMServer 上的 Microsoft Exchange Unified Messaging 服務同時接受 IPv4 和 IPv6 資料封包。
讓信箱伺服器 MyUMServer 上的 Microsoft Exchange Unified Messaging 服務開始使用 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 Server用於從遠端 Lync 或商務用 Skype 用戶端進行輸入和輸出呼叫。
讓信箱伺服器 MyUMServer 上的 Microsoft Exchange Unified Messaging 服務以 TLS 模式啟動。

參數

-Confirm

Confirm 參數會指定要顯示或隱藏確認提示。這個參數對 Cmdlet 的影響取決於 Cmdlet 是否需要確認才能繼續作業。

例如，具破壞性的 Cmdlet (例如 Remove-* Cmdlet) 內建暫停，可強制您在繼續之前確認命令。對於這些 Cmdlet，您可以使用以下確切語法來略過確認提示：-Confirm:$false。
其他大部分的 Cmdlet (例如，New-* 和 Set-* Cmdlet) 沒有內建暫停。在使用這些 Cmdlet 時，指定不含任何值的 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 UM 撥號對應表相關聯，但可以關聯或新增至 SIP 撥號對應表。如果您要整合整合通訊與 Lync Server 2010、Lync Server 2013 或商務用 Skype Server 2015，您需要將所有 Exchange 2016 和 Exchange 2013 伺服器關聯或新增到 SIP 撥號對應表。

您也可以使用此參數，將 Exchange 2010 整合通訊伺服器與 UM 撥號對應表產生關聯。

若要輸入多個值並覆寫任何現有的專案，請使用下列語法： 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 參數會指定此 Cmdlet 用來向 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」 (從星期六下午 10：00 執行到星期六下午 10：15.)
「Sun.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.)

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 參數會指定 UM IP 閘道將使用 IPv4、IPv6 或兩者進行通訊。有效值為：

IPv4
IPv6
任何：先使用 IPv6，如有必要，UM 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) 交易。預設會啟用 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。將 IrmLogMaxAge 參數的值設定為 00：00：00 可防止自動移除 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 MB (MB) 。

有效值是最高 1.999999999 TB (2199023254528 個位元組) 的數值或 unlimited 值。預設值是 6 GB (6442450944 個位元組)。

B (位元組)
KB (千位元組)
MB (百萬位元組)
GB (十億位元組)
TB (TB)

TB (TB)

IrmLogMaxFileSize 參數的值必須小於或等於 IrmLogMaxDirectorySize 參數的值。這兩個參數的有效輸入範圍都是 1 到 9223372036854775807 個位元組。如果輸入 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 MB。

有效值是最高 1.999999999 TB (2199023254528 個位元組) 的數值或 unlimited 值。預設值是 6 GB (6442450944 個位元組)。

B (位元組)
KB (千位元組)
MB (百萬位元組)
GB (十億位元組)
TB (TB)

TB (TB)

IrmLogMaxFileSize 參數的值必須小於或等於 IrmLogMaxDirectorySize 參數的值。這兩個參數的有效輸入範圍都是 1 到 9223372036854775807 個位元組。如果輸入 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 記錄。不過，當$true IrmLogEnabled 參數的值時，將此參數設定為 $null，會在應用程式事件記錄檔中產生錯誤。停用 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 參數會指定最接近 Lync Server 前端集區或商務用 Skype Server前端集區位置的 FQDN 和 TCP 埠，以供遠端 Lync 或商務用 Skype網路外部的使用者進行輸入和輸出呼叫。

建議您一律在跨多個地理區域的 Lync Server 或商務用 Skype Server部署中使用此參數;否則，Microsoft Exchange 整合通訊服務可能會針對Real-Time傳輸通訊協定選取集區， (RTP) 不是最接近遠端使用者的媒體流量。

您可以為每個 Exchange 伺服器) (統一通訊服務的每個實例設定此參數，讓值識別最接近 Exchange 伺服器的 Lync Server 前端集區或商務用 Skype 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 新增至具有不同安全性設定的 UM 撥號對應表，您應該使用此值。

如果您變更此參數的值，則必須重新開機整合通訊服務。

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

若要查看此指令程式可接受的傳回類型 (也就是所謂的輸出類型)，請參閱指令程式輸入和輸出類型。如果 [輸出類型] 欄位是空的，表示指令程式不會傳回資料。