Set-CsServerApplication
上次修改主題的時間： 2012-03-26
修改現有伺服器應用程式的屬性值。伺服器應用程式是 Microsoft Lync Server 2010 託管的應用程式。
語法
Set-CsServerApplication [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-Critical <$true | $false>] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-Priority <Int32>] [-ScriptName <String>] [-Uri <String>] [-WhatIf [<SwitchParameter>]]
Set-CsServerApplication [-Confirm [<SwitchParameter>]] [-Critical <$true | $false>] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-Priority <Int32>] [-ScriptName <String>] [-Uri <String>] [-WhatIf [<SwitchParameter>]]
詳細描述
伺服器應用程式參考 Lync Server 2010 底下執行的個別程式。Set-CsServerApplication 指令程式提供方法，讓系統管理員修改做為 Lync Server 一部分而執行的任何應用程式的內容值。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Set-CsServerApplication Cmdlet：RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsServerApplication"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
Identity |
選用 |
Xds 識別身份 |
要修改之伺服器應用程式的唯一識別碼。伺服器應用程式 Identity 由託管應用程式的服務和應用程式名稱組成。例如，名為 QoEAgent 的伺服器應用程式可能會有如下的 Identity：Registrar:atl-cs-001.litwareinc.com/QoEAgent。 |
Instance |
選用 |
ServerApplication.Application 物件 |
允許您將物件參照傳遞給 Cmdlet，而不設定個別參數值。 |
Critical |
選用 |
布林值 |
如果設為 True (預設值)，除非上述的應用程式可以啟動，否則 Lync Server 將不會啟動。如為 False，不管此應用程式可不可以啟動，Lync Server 都會啟動。 |
Enabled |
選用 |
布林值 |
將此值設為 True 即可啟用此應用程式。將此值設為 False 即可停用此應用程式。 |
Priority |
選用 |
整數 |
指出伺服器應用程式的執行順序。優先順序 0 的應用程式會先啟動，優先順序 1 的應用程式第二個啟動，依此類推。請注意，每個裝載伺服器應用程式的服務都有一組自己的獨特優先順序。例如，登錄器服務可以主控對應到優先順序 0、1, 和 2 的三個應用程式。同樣地，Edge Server 服務可以有四個應用程式；這些應用程式的優先順序為 0、1、2 和 3。 如果您沒有指定優先順序，系統會自動將應用程式加到優先順序清單的最底部。如果您新增或移除應用程式，其他應用程式的優先順序將跟著調整。例如，如果刪除優先順序 0 的應用程式，則原本優先順序 1 的應用程式的優先順序將自動設為 0。 |
ScriptName |
選用 |
字串 |
指向應用程式所使用之 Microsoft SIP Processing Language (MSPL) 指令碼的路徑。MSPL 是用來篩選和轉送 SIP 訊息的指令碼語言。 |
Uri |
選用 |
字串 |
應用程式的唯一統一資源識別項 (URI)。例如，QoEAgent 應用程式的 URI 是 https://www.microsoft.com/LCS/QoEAgent。 |
Force |
選用 |
切換參數 |
隱藏顯示當執行命令時可能發生的任何非嚴重錯誤訊息。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果，但無須實際執行命令。 |
輸入類型
Microsoft.Rtc.Management.WritableConfig.Settings.ServerApplication.Application 物件。Set-CsServerApplication 接受伺服器應用程式物件管線傳送的執行個體。
傳回類型
Set-CsServerApplication 不會傳回值或物件。而是此指令程式會設定 Microsoft.Rtc.Management.WritableConfig.Settings.ServerApplication.application 物件的執行個體。
範例
-------------------------- 範例 1 ------------------------
Set-CsServerApplication -Identity "Registrar:atl-cs-001.litwareinc.com/ExumRouting" -Enabled $True
範例 1 所示的命令會啟用 Identity 為 Registrar:atl-cs-001.litwareinc.com/ExumRouting 的伺服器應用程式。由於識別身分必須是唯一的，因此這個命令只會啟用一個伺服器應用程式。
-------------------------- 範例 2 ------------------------
Get-CsServerApplication | Where-Object {$_.Enabled -eq $False} | Set-CsServerApplication -Enabled $True
前面的命令會啟用所有目前停用的伺服器應用程式。為達成此目的，此命令會先呼叫 Get-CsServerApplication，以傳回組織目前使用的所有伺服器應用程式集合。此集合會接著傳送給 Where-Object，其只會挑出 Enabled 內容等於 False 的應用程式。反過來說，篩選過的集合會傳送給 Set-CsServerApplication，這會取得集合中的每一個項目並將 Enabled 屬性設為 True。