Set-UMServer
這個 Cmdlet 只能在 Exchange Server 2010 中使用。
使用 Set-UMServer Cmdlet 修改與整合通訊 (UM) 伺服器角色相關聯的設定。
如需下方＜語法＞一節中參數集的詳細資訊，請參閱 Exchange Cmdlet 語法。
語法
Default (預設值)
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>]
Description
Set-UMServer Cmdlet 會在整合通訊伺服器上設定特定屬性。 這個 Cmdlet 可用來為指定的 Unified Messaging 伺服器設定個別的 Unified Messaging 參數。
這個工作完成之後，指令程式就會設定參數和指定的值。
您必須已獲指派權限，才能執行此指令程式。 雖然本文列出 Cmdlet 的所有參數，但如果指派給您的權限中未包含某些參數，您可能無法存取這些參數。 若要尋找在組織中執行任何 Cmdlet 或參數所需的權限，請參閱 Find the permissions required to run any Exchange cmdlet。
範例
範例 1
Set-UMServer -Identity MyUMServer -Status NoNewCalls
此範例會防止整合通訊伺服器 MyUMServer 接受新的呼叫。
範例 2
Set-UMServer -Identity MyUMServer -DialPlans $null
本範例會從所有 UM 撥號對應表中移除整合通訊伺服器 MyUMServer。
範例 3
Set-UMServer -Identity MyUMServer -DialPlans MyUMDialPlanName -MaxCallsAllowed 50
此範例會將整合通訊伺服器 MyUMServer 新增至 UM 撥號對應表 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
本範例會將文法產生排程變更為每天在整合通訊伺服器 MyUMServer 上的 02：30-03：00。
參數
-Confirm
適用：Exchange Server 2010
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 2010
DialPlans 參數會指定伺服器處理 UM 呼叫的撥號對應表。 您可以指定多個以逗號分隔的值。
如果未指定撥號對應表，整合通訊伺服器不會處理 UM 通話。
參數屬性
| 類型: | MultiValuedProperty |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-DomainController
適用：Exchange Server 2010
DomainController 參數會指定此 Cmdlet 用來向 Active Directory 讀取或寫入資料的網域控制站。 您可以透過網域控制站的完整網域名稱 (FQDN) 來識別網域控制站。 例如，dc01.contoso.com。
參數屬性
| 類型: | Fqdn |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ExternalServiceFqdn
適用：Exchange Server 2010
ExternalServiceFqdn 參數是提供服務之整合通訊伺服器之負載平衡器的 FQDN 或主機名稱。 當您要將組織內部的整合通訊伺服器移轉至 Microsoft Exchange Server 2010 裝載環境時，此參數非常有用。 外部服務主機 FQDN 最多可包含 2,048 個字元。
參數屬性
| 類型: | UMSmartHost |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-GrammarGenerationSchedule
適用：Exchange Server 2010
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 2010
Identity 參數會指定您要修改的整合通訊伺服器。 您可以使用唯一識別伺服器的任何值。 例如：
- 名稱
- GUID
- 辨別名稱 (DN)
- ExchangeLegacyDN
參數屬性
| 類型: | UMServerIdParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | 1 |
| 必要: | True |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-IrmLogEnabled
適用：Exchange Server 2010
IrmLogEnabled 參數指定是否要啟用資訊版權管理 (IRM) 交易的記錄。 預設會啟用 IRM 記錄。 值包括：
- $true 啟用 IRM 記錄
- $false 停用 IRM 記錄
參數屬性
| 類型: | Boolean |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-IrmLogMaxAge
適用：Exchange Server 2010
IrmLogMaxAge 參數會指定 IRM 記錄檔的保留天數上限。 會刪除較指定值較舊的記錄檔。 預設值是 30 天。 若要指定值，請將值輸入為時間範圍：dd.hh：mm：ss，其中 d = 天、h = 小時、m = 分鐘、s = 秒。 此參數的有效輸入範圍是 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 2010
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 2010
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 2010
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 2010
MaxCallsAllowed 參數會指定整合通訊伺服器允許的並行語音通話數目上限。
參數屬性
| 類型: | Int32 |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-SIPAccessService
適用：Exchange Server 2010
SIPAccessService 參數會指定最近的 Lync Server 邊緣集區或商務用 商務用 Skype Server 邊緣集區位置的 FQDN 和 TCP 連接埠，以供來自網路外部遠端 Lync 或商務用 Skype 使用者的傳入和傳出通話商務用 Skype。
建議您一律在跨越多個地理區域的 Lync Server 或商務用 Skype Server部署中使用此參數;否則，整合通訊伺服器可能會針對地理位置上不是最接近遠端使用者的媒體流量，選取 Real-Time 傳輸通訊協定 (RTP) 集區。
您可以為每個整合通訊伺服器設定此參數，讓該值識別最接近 Exchange 伺服器的 Lync Server 邊緣集區或商務用商務用 Skype Server 邊緣集區。
參數屬性
| 類型: | ProtocolConnectionSettings |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-SipTcpListeningPort
適用：Exchange Server 2010
SipTcpListeningPort 參數會指定整合通訊伺服器用來接收來電的 TCP 連接埠。 新增到未設定為使用 SIP 安全或安全模式的 UM 撥號對應表的整合通訊伺服器會使用此 TCP 連接埠。 預設值為連接埠 5060。
參數屬性
| 類型: | Int32 |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-SipTlsListeningPort
適用：Exchange Server 2010
SipTlsListeningPort 參數會指定整合通訊伺服器用來接收來電的傳輸層安全性 (TLS) 連接埠。 此 TLS 連接埠可由新增至設定為使用 SIP 安全或安全模式的 UM 撥號對應表中的整合通訊伺服器使用。 預設值為連接埠 5061。
參數屬性
| 類型: | Int32 |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Status
適用：Exchange Server 2010
Status 參數會指定整合通訊伺服器的狀態。 可用的選項有 [已啟用]、[已停用] 和 [NoNewCalls]。
參數屬性
| 類型: | ServerStatus |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-UMStartupMode
適用：Exchange Server 2010
UMStartupMode 參數指定 Exchange 伺服器上 Microsoft Exchange 整合通訊服務的啟動模式。 有效值為：
- TCP
- TLS
- 雙重：使用此值可將整合通訊伺服器新增至具有不同安全性設定的 UM 撥號對應表。 整合通訊伺服器可以同時接聽連接埠 5060 和 5061。
如果您變更啟動模式，則必須重新啟動 Microsoft Exchange 整合通訊服務。
參數屬性
| 類型: | UMStartupMode |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-WhatIf
適用：Exchange Server 2010
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
若要查看此指令程式可接受的傳回類型 (也就是所謂的輸出類型)，請參閱指令程式輸入和輸出類型。 如果 [輸出類型] 欄位是空的，表示指令程式不會傳回資料。