Set-CsApplicationServer
上次修改主題的時間： 2012-03-27
可讓您修改一或多個執行 應用程式服務 的組態屬性。這些伺服器 (也稱為應用程式伺服器) 主控許多軟體程式，例如，使用 Microsoft Unified Communications Managed API (UCMA) 集開發的 通話駐留應用程式。
語法
Set-CsApplicationServer [-Identity <XdsGlobalRelativeIdentity>] [-ApplicationDatabase <String>] [-AppSharingPortCount <UInt16>] [-AppSharingPortStart <UInt16>] [-AtsSipPort <UInt16>] [-AudioPortCount <UInt16>] [-AudioPortStart <UInt16>] [-CaaSipPort <UInt16>] [-CasSipPort <UInt16>] [-Confirm [<SwitchParameter>]] [-CpsSipPort <UInt16>] [-Force <SwitchParameter>] [-PdpSipPort <UInt16>] [-PdpTurnPort <UInt16>] [-Registrar <String>] [-RgsSipPort <UInt16>] [-RgsWcfMtlsPort <UInt16>] [-VideoPortCount <UInt16>] [-VideoPortStart <UInt16>] [-WhatIf [<SwitchParameter>]]
詳細描述
應用程式服務 主控幾個不屬於核心伺服器元件的 Microsoft Lync Server 2010 程式；這些程式包括 回應群組應用程式、會議服務員應用程式 以及 會議宣告應用程式。應用程式服務 會採用這些程式，並將這些程式完全整合到 Lync Server 2010 環境中。
Set-CsApplicationServer 指令程式可讓系統管理員修改其組織中部署之任何 (或所有) 應用程式伺服器的組態設定。例如，您可以修改音訊、視訊或應用程式共用流量所使用的連接埠，或是為個別應用程式 (如 會議服務員應用程式 或 會議宣告應用程式) 使用的連接埠指派新值。請注意，只要您變更連接埠，就必須重新啟動對應的服務。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Set-CsApplicationServer Cmdlet：RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsApplicationServer"}
參數
| 參數 | 必要 | 類型 | 說明 |
|---|---|---|---|
Identity |
必要 |
Xds 識別碼 |
要修改之應用程式伺服器的服務位置。例如：-Identity "ApplicationServer:atl-cs-001.litwareinc.com"。 請注意，您可以省略前置字元 "ApplicationServer"：指定應用程式伺服器時。例如：-Identity "atl-cs-001.litwareinc.com"。 |
ApplicationDatabase |
選用 |
字串 |
應用程式資料庫 的服務位置。例如：-ApplicationDatabase "ApplicationDatabase:atl-cs-001.litwareinc.com"。 |
AppSharingPortCount |
選用 |
整數 |
配置給應用程式共用的連接埠總數。要開放的實際連接埠將以針對 AppSharingPortStart 設定的值開始，然後繼續加上針對 AppSharingPortCount 指定的連接埠數目。例如，如果 AppSharingPortStart 設為 60000，而 AppSharingPortCount 設為 100，則連接埠 60000 至 60099 將會用於應用程式共用。 |
AppSharingPortStart |
選用 |
整數 |
配置給應用程式共用的連接埠範圍中的第一個連接埠。例如：–AppSharingPortStart 60000。 |
AtsSipPort |
選用 |
整數 |
用於音訊測試服務的通訊埠。 |
AudioPortCount |
選用 |
整數 |
配置給傳送和接收音訊流量的連接埠總數。要開放的實際連接埠將以針對 AudioPortStart 設定的值開始，然後繼續加上針對 AudioPortCount 指定的連接埠數目。例如，如果 AudioPortStart 設為 60000，而 AudioPortCount 設為 100，則連接埠 60000 至 60099 將會用於音訊流量。 |
AudioPortStart |
選用 |
整數 |
配置給傳送和接收音訊流量之連接埠範圍中的第一個連接埠。例如：–AudioPortStart 60000。 |
CaaSipPort |
選用 |
整數 |
會議服務員應用程式 使用的 SIP 連接埠，當使用者連線到撥入式會議時會使用該連接埠。 |
CasSipPort |
選用 |
整數 |
會議宣告應用程式 使用的 SIP 連接埠，用於在會議期間播放宣告 (例如，「Ken Myer 現在要離開」)。 |
CpsSipPort |
選用 |
整數 |
通話駐留服務使用的 SIP 連接埠。通話駐留服務可讓您保留某個電話的通話，然後從不同電話擷取該通來電。 |
PdpSipPort |
選用 |
整數 |
原則決策點 伺服器所使用的 SIP 連接埠。原則決策點 伺服器是用於頻寬管理。 |
PdpTurnPort |
選用 |
整數 |
轉換 原則決策點 伺服器使用的流量連接埠。 |
Registrar |
選用 |
字串 |
與 原則決策點 伺服器相關聯之登錄器的完整網域名稱。 |
RgsSipPort |
選用 |
整數 |
回應群組應用程式 所使用的 SIP 連接埠。回應群組應用程式 會提供一種方式，將來電導向至特定一組人員，例如組織的支援小組。 |
RgsWcfMtlsPort |
選用 |
整數 |
回應群組應用程式 所使用之 Windows Communication Foundation (WCF) 相互傳輸層安全性 (MTLS) 流量使用的連接埠。 |
VideoPortCount |
選用 |
整數 |
配置給傳送和接收視訊流量的連接埠總數。要開放的實際連接埠將以針對 VideoPortStart 設定的值開始，然後繼續加上針對 VideoPortCount 指定的連接埠數目。例如，如果 VideoPortStart 設為 60000，而 VideoPortCount 設為 100，則連接埠 60000 至 60099 將會用於視訊流量。 |
VideoPortStart |
選用 |
整數 |
配置給傳送和接收視訊流量之連接埠範圍中的第一個連接埠。例如 –VideoPortStart 60000。 |
Force |
選用 |
切換參數 |
隱藏顯示當執行命令時可能發生的任何非嚴重錯誤訊息。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果，但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
無。Set-CsApplicationServer 不會接受管線傳送的輸入。
傳回類型
Set-CsApplicationServer 不會傳回任何值或物件。而是由指令程式修改 Microsoft.Rtc.Management.Xds.DisplayApplicationServer 物件的現有執行個體。
範例
-------------------------- 範例 1 ------------------------
Set-CsApplicationServer -Identity "ApplicationServer:atl-cs-001.litwareinc.com" -CasSipPort 5074
範例 1 所示的命令會將應用程式伺服器 ApplicationServer:atl-cs-001.litwareinc.com 上 會議宣告應用程式 的 SIP 連接埠設為 5074。
-------------------------- 範例 2 ------------------------
Set-CsApplicationServer -Identity "ApplicationServer:atl-cs-001.litwareinc.com" -AudioPortStart 49500 -AudioPortCount 5500
以上的命令會設定應用程式伺服器 ApplicationServer:atl-cs-001.litwareinc.com 的音訊連接埠。在此範例中，開始音訊連接埠設為 49500，而總共預留了 5500 個連接埠供音訊流量使用。
-------------------------- 範例 3 ------------------------
Get-CsService -ApplicationServer | ForEach-Object {Set-CsApplicationServer -Identity $_.Identity -CasSipPort 5074}
範例 3 中，會將組織內所有應用程式伺服器之 會議宣告應用程式 的 SIP 連接埠設為 5074。若要這樣做，此命令會先使用 Get-CsService 傳回目前使用中之所有應用程式伺服器的集合。接著，此集合會傳送到 ForEach-Object 指令程式，以取得集合中的每個伺服器，然後使用 Set-CsApplicationServer，將 會議宣告應用程式 SIP 連接埠設為 5074。