Set-UmServer

參考

模組:: ExchangePowerShell

適用於:: Exchange Server 2010

此 Cmdlet 僅適用于 2010 Exchange Server。

使用 Set-UMServer Cmdlet 來修改與整合通訊 (UM) 伺服器角色相關聯的設定。

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

Syntax

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 可用來為指定的整合通訊伺服器設定個別的整合通訊參數。

這個工作完成之後，指令程式就會設定參數和指定的值。

您必須已獲指派權限，才能執行此指令程式。雖然本主題已列出這個指令程式的所有參數，不過，如果某些參數並未包含在指派給您的權限中，您可能就無法存取這些參數。若要尋找在組織中執行任何 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

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 2010

-DialPlans

DialPlans 參數會指定此伺服器將處理 UM 呼叫的所有撥號對應表。如果未定義撥號對應表，則整合通訊伺服器將不會處理 UM 呼叫。

Type:	MultiValuedProperty
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

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

-ExternalServiceFqdn

ExternalServiceFqdn 參數是服務整合通訊伺服器之負載平衡器的 FQDN 或主機名稱。當您將整合通訊伺服器從組織內移轉至 Microsoft Exchange Server 2010 託管環境時，此參數非常有用。外部服務主機 FQDN 最多可包含 2，048 個字元。

Type:	UMSmartHost
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

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

-Identity

Identity 參數會指定您要修改的整合通訊伺服器。您可以使用唯一識別伺服器的任何值。例如：

名稱
GUID
辨別名稱 (DN)
ExchangeLegacyDN

Type:	UMServerIdParameter
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

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

-IrmLogMaxAge

IrmLogMaxAge 參數會指定 IRM 記錄檔的保留天數上限。會刪除較指定值較舊的記錄檔。預設值是 30 天。若要指定值，請輸入值作為時間範圍：dd.hh：mm：ss，其中 d = days、h = hours、m = minutes 和 s = seconds。此參數的有效輸入範圍是 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 2010

-IrmLogMaxDirectorySize

IrmLogMaxDirectorySize 參數會指定連線記錄目錄中所有 IRM 記錄的大小上限。目錄達到檔案大小上限時，伺服器會先刪除最舊的記錄檔。預設值為 250 MB (MB) 。有效值是最高 1.999999999 TB (2199023254528 個位元組) 的數值或 unlimited 值。預設值是 6 GB (6442450944 個位元組)。

B (位元組)
KB (千位元組)
MB (百萬位元組)
GB (十億位元組)
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 2010

-IrmLogMaxFileSize

IrmLogMaxFileSize 參數會指定每個 IRM 記錄檔的大小上限。當記錄檔達到其最大的檔案大小時，將建立新的記錄檔。預設值為 10 MB。有效值是最高 1.999999999 TB (2199023254528 個位元組) 的數值或 unlimited 值。預設值是 6 GB (6442450944 個位元組)。

B (位元組)
KB (千位元組)
MB (百萬位元組)
GB (十億位元組)
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 2010

-IrmLogPath

IrmLogPath 參數會指定預設的 IRM 記錄檔目錄位置。預設值為 C：\Program Files\Microsoft\Exchange Server\V14。如果將 IrmLogPath 參數的值設為 $null，便可有效地停用 IRM 記錄。不過，如果您在$true IrmLogEnabled 屬性的值時，將 IrmLogPath 參數的值設定為 $null，Exchange 會在 Application 事件記錄檔中記錄錯誤。停用 IRM 記錄的慣用方式是將 IrmLogEnabled 參數設定為 $false。

Type:	LocalLongFullPath
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-MaxCallsAllowed

MaxCallsAllowed 參數會指定整合通訊伺服器允許的並行語音電話數目上限。

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-SIPAccessService

SIPAccessService 參數會指定最接近 Lync Server Edge 集區或商務用 Skype Server Edge 集區位置的 FQDN 和 TCP 埠，以供遠端 Lync 或商務用 Skype網路外部的使用者進行輸入和輸出呼叫。

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

您可以為每個整合通訊伺服器設定此參數，讓值識別最接近 Exchange 伺服器的 Lync Server Edge 集區或商務用 Skype Server Edge 集區。

Type:	ProtocolConnectionSettings
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-SipTcpListeningPort

SipTcpListeningPort 參數會指定整合通訊伺服器用來接收來電的 TCP 埠。新增到未設定為使用 SIP 安全或安全模式之 UM 撥號對應表的整合通訊伺服器會使用此 TCP 埠。預設值為埠 5060。

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-SipTlsListeningPort

SipTlsListeningPort 參數會指定整合通訊伺服器用來接收來電的傳輸層安全性 (TLS) 埠。此 TLS 埠是由已新增至設定為使用 SIP 安全或安全模式之 UM 撥號對應表的整合通訊伺服器所使用。預設值為埠 5061。

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-Status

Status 參數會指定 Unified Messaging 伺服器狀態。可用的選項為 Enabled、Disabled 和 NoNewCalls。

Type:	ServerStatus
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-UMStartupMode

UMStartupMode 參數會指定整合通訊伺服器上的 Microsoft Exchange Unified Messaging 服務是否會以 TCP、TLS 或雙重模式啟動。如果整合通訊伺服器新增至具有不同安全性設定的 UM 撥號對應表，您應該選擇 [雙重模式]。在雙重模式中，整合通訊伺服器可以同時接聽埠 5060 和 5061。如果啟動模式已變更，則必須重新開機Microsoft Exchange 整合通訊服務。

Type:	UMStartupMode
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

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

輸入

Input types

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

輸出

Output types

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