New-CsServerApplication
上次修改主題的時間： 2012-03-26
建立新的伺服器應用程式。伺服器應用程式是由 Microsoft Lync Server 2010 主控的應用程式。
語法
New-CsServerApplication -Identity <XdsIdentity> -Uri <String> [-Confirm [<SwitchParameter>]] [-Critical <$true | $false>] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-Priority <Int32>] [-ScriptName <String>] [-WhatIf [<SwitchParameter>]]
New-CsServerApplication -Name <String> -Parent <String> -Uri <String> [-Confirm [<SwitchParameter>]] [-Critical <$true | $false>] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-Priority <Int32>] [-ScriptName <String>] [-WhatIf [<SwitchParameter>]]
詳細描述
伺服器應用程式是指在 Microsoft Lync Server 2010 下執行的個別程式。New-CsServerApplication 指令程式會提供一種方式，讓系統管理員設定新的伺服器應用程式。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 New-CsServerApplication Cmdlet：RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsServerApplication"}
參數
| 參數 | 必要 | 類型 | 說明 |
|---|---|---|---|
Identity |
選用 |
Xds 識別碼 |
要建立之伺服器應用程式的唯一識別碼。伺服器應用程式的 Identity 是由主控應用程式的服務加上應用程式名稱組成。例如，名稱為 QoEAgent 之伺服器應用程式的 Identity 會類似如下：service:Registrar:atl-cs-001.litwareinc.com/QoEAgent。 |
Parent |
必要 |
字串 |
指定將主控新伺服器應用程式的服務。如果使用了 Identity 參數，您就不需要使用 Parent 或 Name 參數；那是因為應用程式 Identity 已結合了 Parent 和 Name 屬性的值。不過，您可以省略 Identity 參數，而改用 Parent 和 Name 參數。在該情況下，Parent 參數的外觀必須類似如下：-Parent "Registrar:atl-cs-001.litwareinc.com"。 |
Name |
必要 |
字串 |
服務的易記名稱。如果使用 Identity 參數，您就不需要在建立新服務時加入 Name 參數；Name 屬性會使用應用程式 Identity 的名稱部分填入。例如，如果建立 Identity 為 service:Registrar:atl-cs-001.litwareinc.com/TestService 的新應用程式，就會自動將該應用程式命名為 TestService。只有在使用 Parent 參數時，才需要 Name 參數。 |
Uri |
必要 |
字串 |
應用程式的唯一統一資源識別項 (URI)。例如，QoEAgent 應用程式的 URI 為 https://www.microsoft.com/LCS/QoEAgent。 |
Enabled |
選用 |
布林值 |
將此值設為 True 可啟用應用程式。將此值設為 False 即可停用此應用程式。如果未指定此參數，則 Enabled 內容會設為 False，並停用新應用程式。 |
Critical |
選用 |
布林值 |
如果設為 True，除非上述的應用程式可以啟動，否則 Lync Server 將不會啟動。如為 False，不管此應用程式可不可以啟動，Lync Server 都會啟動。如果未指定此參數，Critical 內容會設為 True。 |
ScriptName |
選用 |
字串 |
應用程式使用的 Microsoft SIP Processing Language (MSPL) 指令碼的路徑 (若適用的話)。MSPL 是用來篩選和轉送 SIP 訊息的指令碼語言。 |
Priority |
選用 |
整數 |
表示伺服器應用程式的執行順序。優先順序為 0 的應用程式會先啟動；優先順序為 1 的應用程式會第二個啟動，依此類推。請注意，主控伺服器應用程式的每個服務都有其自己唯一的一組優先順序。例如，登錄器服務可以主控對應到優先順序 0、1, 和 2 的三個應用程式。同樣地，Edge Server 服務可以有四個應用程式；這些應用程式的優先順序為 0、1、2 和 3。 如果您沒有指定優先順序，則會自動將應用程式新增至優先順序清單的底部。如果您新增或移除應用程式，其他應用程式的優先順序會依此調整。例如，如果您刪除優先順序為 0 的應用程式，則先前優先順序為 1 的應用程式會將其優先順序自動設為 0。 |
InMemory |
選用 |
切換參數 |
建立物件參照，但而不實際將物件認可為永久變更。若將此參數所呼叫的 Cmdlet 輸出指派給變數，將可變更物件參照的屬性，然後呼叫此 Cmdlet 的對應 Set- Cmdlet 認可這些變更。 |
Force |
選用 |
切換參數 |
隱藏顯示當執行命令時可能發生的任何非嚴重錯誤訊息。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果，但無須實際執行命令。 |
Confirm |
選用 |
執行命令前先要求您確認。 |
輸入類型
無。New-CsServerApplication 不接受管線傳送的輸入。
傳回類型
New-CsServerApplication 會建立 Microsoft.Rtc.Management.WritableConfig.Settings.ServerApplication.Application 物件的新執行個體。
範例
-------------------------- 範例 1 ------------------------
New-CsServerApplication -Identity "EdgeServer:atl-edge-001.litwareinc.com/EdgeMonitor" -Uri http://www.litwareinc.com/edgemonitor -Critical $False
範例 1 會建立 Identity 為 EdgeServer:atl-edge-001.litwareinc.com/EdgeMonitor 的新伺服器應用程式。除了指定 Identity 之外，還會加上 Uri 和 Critical 參數；這些參數是用來指定應用程式 URI，並表示此應用程式不被視為關鍵。
-------------------------- 範例 2 ------------------------
$x = New-CsServerApplication -Identity "EdgeServer:atl-edge-001.litwareinc.com/EdgeMonitor" -InMemory
$x.Uri = "http://www.litwareinc.com/edgemonitor"
$x.Critical = $False
Set-CsServerApplication -Instance $x
範例 2 所示的命令會示範如何建立一開始只存在於記憶體中的新伺服器應用程式。若要這樣做，第一個命令會呼叫隨附兩個參數的 New-CsServerApplication：Identity (指定應用程式的 Identity) 和 InMemory (表示新應用程式只應在記憶體中建立) 然後，產生的伺服器應用程式物件會儲存在變數 $x 中。
建立此虛擬伺服器應用程式後，命令 2 和 3 會分別用來修改 Uri 和 Critical 屬性的值。最後，命令 4 是用來將虛擬伺服器應用程式轉換為實際的伺服器應用程式。請注意，這個最終的命令是必要的。如果您沒有呼叫 Set-CsServerApplication，就不會為 EdgeServer:atl-edge-001.litwareinc.com/EdgeMonitor 設定應用程式，而且只要您一結束 Windows PowerShell 工作階段或刪除變數 $x，虛擬應用程式就會消失。