Set-UMService
內部部署 Exchange 才有提供此 Cmdlet。
使用 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>]
Description
您必須已獲指派權限，才能執行此指令程式。 雖然本文列出 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 Server 用於從遠端 Lync 或 商務用 Skype 用戶端進行傳入和傳出呼叫。
- 讓信箱伺服器 MyUMServer 上的 Microsoft Exchange 整合通訊服務以 TLS 模式啟動。
參數
-Confirm
適用：Exchange Server 2013、Exchange Server 2016
Confirm 參數會指定要顯示或隱藏確認提示。 此參數對 Cmdlet 的影響取決於 Cmdlet 是否需要確認才能繼續。
- 破壞性的 Cmdlet (如 Remove-* cmdlets) 有內建暫停，它會先強迫您確認命令才會繼續作業。 對於這些 Cmdlet，您可以使用以下確切語法來略過確認提示：
-Confirm:$false。 - 其他大部分的 Cmdlet (如 New-* 和 Set-* cmdlets) 則沒有內建暫停。 針對這些 Cmdlet，指定不帶值的 Confirm 參數會造成暫停，強制您在繼續之前先確認命令。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | CF |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-DialPlans
適用：Exchange Server 2013、Exchange Server 2016
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"...}。
參數屬性
| 類型: | MultiValuedProperty |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-DomainController
適用：Exchange Server 2013、Exchange Server 2016
DomainController 參數會指定此 Cmdlet 用來向 Active Directory 讀取或寫入資料的網域控制站。 您可以透過網域控制站的完整網域名稱 (FQDN) 來識別網域控制站。 例如，dc01.contoso.com。
參數屬性
| 類型: | Fqdn |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | 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” (週六晚上 10：00 至週六晚上 10：15 運行 ) 。
- 「週日凌晨 1：15 至週一 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
適用：Exchange Server 2013、Exchange Server 2016
Identity 參數會指定承載您要修改之整合通訊服務設定的信箱伺服器。 您可以使用唯一識別伺服器的任何值。 例如：
- 名稱
- 辨別名稱 (DN)
- ExchangeLegacyDN
- GUID
參數屬性
| 類型: | UMServerIdParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | 1 |
| 必要: | True |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-IPAddressFamily
適用：Exchange Server 2013、Exchange Server 2016
IPAddressFamily 參數會指定要使用的網際網路通訊協定 (IP) 版本。 有效值為：
- IPv4Only：UM IP 閘道只使用 IPv4 進行通訊。
- IPv6Only：UM IP 閘道只使用 IPv6。
- 任何：優先使用 IPv6。 如果 IPv6 無法使用，則會使用 IPV4。 此值為預設值。
參數屬性
| 類型: | IPAddressFamily |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-IPAddressFamilyConfigurable
適用：Exchange Server 2013、Exchange Server 2016
IPAddressFamilyConfigurable 參數會指定您是否可以將 IPAddressFamily 參數設定為 IPv6Only 或 Any。 預設為 $True。
參數屬性
| 類型: | Boolean |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-IrmLogEnabled
適用：Exchange Server 2013、Exchange Server 2016
IrmLogEnabled 參數指定是否要啟用資訊版權管理 (IRM) 交易的記錄。 預設會啟用 IRM 記錄。 有效值為：
- $true：啟用 IRM 記錄
- $false：停用 IRM 記錄
參數屬性
| 類型: | Boolean |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | 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。 將 IrmLogMaxAge 參數的值設定為 00：00：00 可防止自動移除 IRM 記錄檔，因為它們已經過時了。
參數屬性
| 類型: | EnhancedTimeSpan |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-IrmLogMaxDirectorySize
適用：Exchange Server 2013、Exchange Server 2016
IrmLogMaxDirectorySize 參數會指定連線記錄目錄中所有 IRM 記錄的大小上限。 目錄達到檔案大小上限時，伺服器會先刪除最舊的記錄檔。 預設值為 250 MB (MB) 。
有效值是最高 1.999999999 TB (2199023254528 個位元組) 的數值或 unlimited 值。預設值是 6 GB (6442450944 個位元組)。
- B (位元組)
- KB (千位元組)
- MB (百萬位元組)
- GB (十億位元組)
- TB (兆位元組)
不完整的值通常被視為位元組，但較小的值可能會進位到最接近的千位元組。
IrmLogMaxFileSize 參數的值必須小於或等於 IrmLogMaxDirectorySize 參數的值。 這兩個參數的有效輸入範圍都是 1 到 9223372036854775807 個位元組。 如果輸入 unlimited 值，則不會限制連線記錄目錄的大小。
參數屬性
| 類型: | Unlimited |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-IrmLogMaxFileSize
適用：Exchange Server 2013、Exchange Server 2016
IrmLogMaxFileSize 參數會指定每個 IRM 記錄檔的大小上限。 當記錄檔達到其最大的檔案大小時，將建立新的記錄檔。 預設值為 10 MB。
有效值是最高 1.999999999 TB (2199023254528 個位元組) 的數值或 unlimited 值。預設值是 6 GB (6442450944 個位元組)。
- B (位元組)
- KB (千位元組)
- MB (百萬位元組)
- GB (十億位元組)
- TB (兆位元組)
不完整的值通常被視為位元組，但較小的值可能會進位到最接近的千位元組。
IrmLogMaxFileSize 參數的值必須小於或等於 IrmLogMaxDirectorySize 參數的值。 這兩個參數的有效輸入範圍都是 1 到 9223372036854775807 個位元組。 如果輸入 unlimited 值，則不會限制 IRM 記錄檔案的大小。
參數屬性
| 類型: | ByteQuantifiedSize |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | 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 |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-MaxCallsAllowed
適用：Exchange Server 2013、Exchange Server 2016
MaxCallsAllowed 參數會指定整合通訊服務允許的並行語音通話數目上限。 預設值為 100。
參數屬性
| 類型: | Int32 |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-SIPAccessService
適用：Exchange Server 2013、Exchange Server 2016
SIPAccessService 參數會指定最近的 Lync Server 前端集區或前端集區位置的 FQDN 和 TCP 連接埠商務用 Skype Server用於來自網路外部遠端 Lync 或商務用 Skype使用者的傳入和傳出呼叫。
建議您一律在跨越多個地理區域的 Lync Server 或 商務用 Skype Server 部署中使用此參數;否則，Microsoft Exchange 整合通訊服務可能會針對地理位置上不是最接近遠端使用者的媒體流量，選取 Real-Time 傳輸通訊協定 (RTP) 集區。
您可以為每個 Exchange 伺服器) (每個整合通訊服務執行個體設定此參數商務用 Skype Server以便該值識別出最接近 Exchange 伺服器的 Lync Server 前端集區或前端集區。
參數屬性
| 類型: | ProtocolConnectionSettings |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Status
適用：Exchange Server 2013、Exchange Server 2016
此參數已棄用，不再使用。
參數屬性
| 類型: | ServerStatus |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-UMStartupMode
適用：Exchange Server 2013、Exchange Server 2016
UMStartupMode 參數會指定整合通訊服務的啟動模式。 有效值為：
- TCP (預設值)
- TLS
- 雙重：服務可以同時接聽連接埠 5060 和 5061。 如果您將 Exchange 伺服器新增至具有不同安全性設定的 UM 撥號對應表，您應該使用此值。
如果您變更此參數的值，則需要重新啟動整合通訊服務。
參數屬性
| 類型: | UMStartupMode |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-WhatIf
適用：Exchange Server 2013、Exchange Server 2016
WhatIf 參數會顯示命令在不進行任何變更的情況下執行的動作。 您不需要使用此參數指定值。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | WI |
參數集
(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
若要查看此指令程式可接受的輸入類型，請參閱指令程式輸入和輸出類型。 如果指令程式的 [輸入類型] 欄位是空的，表示指令程式不接受輸入資料。
輸出
Output types
若要查看此指令程式可接受的傳回類型 (也就是所謂的輸出類型)，請參閱指令程式輸入和輸出類型。 如果 [輸出類型] 欄位是空的，表示指令程式不會傳回資料。