Get-CsServerApplication
上次修改主題的時間： 2012-03-23
傳回用於組織的伺服器應用程式相關資訊。伺服器應用程式是 Microsoft Lync Server 2010 託管的應用程式。
語法
Get-CsServerApplication [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]
Get-CsServerApplication [-Filter <String>] [-LocalStore <SwitchParameter>]
詳細描述
伺服器應用程式是指在 Lync Server 2010 下執行的個別程式。Get-CsServerApplication 指令程式提供一種方法，讓系統管理員可以傳回作為 Lync Server 組件執行的任何 (或所有) 應用程式資訊。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Get-CsServerApplication Cmdlet：RTCUniversalUserAdmins、RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsServerApplication"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
Identity |
選用 |
Xds 識別身份 |
要擷取之伺服器應用程式的唯一識別碼。伺服器應用程式 Identity 由託管應用程式的服務和應用程式名稱組成。例如，名為 QoEAgent 的伺服器應用程式可能會有如下的 Identity：service:Registrar:atl-cs-001.litwareinc.com/QoEAgent。 若要擷取在指定服務上執行的所有應用程式集合，只要略過以下應用程式名稱： -Identity "Registrar:atl-cs-001.litwareinc.com " 如果省略此參數，當您呼叫 Get-CsServerApplication 時，會傳回所有伺服器應用程式。 |
Filter |
選用 |
字串 |
讓您可以在作為伺服器應用程式或伺服器應用程式集合傳回時，使用萬用字元。例如，若要傳回 Identity 中具有字串值 "IIMFilter" 的所有伺服器應用程式，請使用此語法：-Filter "*IIMFilter*"。 |
LocalStore |
選用 |
切換參數 |
從中央管理存放區本機複本擷取伺服器應用程式資料，而不是從中央管理存放區本身擷取。 |
輸入類型
無。Get-CsServerApplication 不會接受管線傳送的輸入。
傳回類型
Get-CsServerApplication 會傳回 Microsoft.Rtc.Management.WritableConfig.Settings.ServerApplication.Application 物件的執行個體。
範例
-------------------------- 範例 1 ------------------------
Get-CsServerApplication
範例 1 所示的命令會傳回目前用於組織的所有伺服器應用程式資訊。這可以利用呼叫不含任何參數的 Get-CsServerApplication 來完成。
-------------------------- 範例 2 ------------------------
Get-CsServerApplication -Identity "service:EdgeServer:atl-edge-001.litwareinc.com"
範例 2 中，會傳回所有在 EdgeServer:atl-edge-001.litwareinc.com 服務上執行的伺服器應用程式資訊。
-------------------------- 範例 3 ------------------------
Get-CsServerApplication -Identity "service:Registrar:atl-cs-001.litwareinc.com/ExumRouting"
範例 3 會傳回單一伺服器應用程式的資訊：Identity 為 Registrar:atl-cs-001.litwareinc.com/ExumRouting" 的應用程式。
-------------------------- 範例 4 ------------------------
Get-CsServerApplication -Filter "service:*:atl-cs-001.litwareinc.com*"
上述命令會傳回設定用於 atl-cs-001.litwareinc.com 集區的所有伺服器應用程式。這可以透過使用 Filter 參數和篩選值 "service:*:atl-cs-001.litwareinc.com*" 來完成。篩選值限制傳回具有以字元 "service:" 為開頭之 Identity 的應用程式資料，並包含字元 ":atl-cs-001.litwareinc.com"。
-------------------------- 範例 5 ------------------------
Get-CsServerApplication | Where-Object {$_.Enabled -eq $False}
範例 5 中，會傳回目前已停用的所有伺服器應用程式資訊。為了完成這項工作，命令會先呼叫 Get-CsServerApplication 以傳回設定用於組織的所有伺服器應用程式集合。接著將此集合傳送給 Where-Object 指令程式，這樣只會選取 Enabled 屬性等於 False 的應用程式。
-------------------------- 範例 6 ------------------------
Get-CsServerApplication | Where-Object {$_.Critical -eq $True -and $_.Enabled -eq $False}
範例 6 是範例 5 所示的命令變化。範例 6 中，會傳回標記為重要且目前已停用的所有伺服器應用程式資訊。如果要執行這項作業，命令會先呼叫不含任何參數的 Get-CsServerApplication，傳回設定供使用的所有伺服器應用程式集合。這個集合會被傳送到 Where-Object，僅挑選出那些符合兩個準則的應用程式：Critical 內容必須等於 True 且 Enabled 內容必須等於 False。-and 運算子確保只傳回同時符合準則的物件。
-------------------------- 範例 7 ------------------------
Get-CsServerApplication | Where-Object {$_.Uri -like "*routing*"}
範例 7 中，會傳回 Uri 中具有字串值 "routing" 的所有伺服器應用程式資訊。這項工作的完成，是透過先使用 Get-CsServerApplication，擷取目前使用中的所有伺服器應用程式。產生的集合便會傳送到 Where-Object，僅選取 UI 屬性包含字串值 "routing" 的應用程式。
-------------------------- 範例 8 ------------------------
Get-CsServerApplication | Where-Object {$_.ScriptName -ne $Null}
上述命令會傳回已指派指令碼的所有伺服器應用程式資訊。如果要執行這項作業，命令會先擷取目前使用中的所有伺服器應用程式集合；此資訊透過呼叫不含任何參數的 Get-CsServerApplication 來擷取。伺服器應用程式的完整集合便會傳送到 Where-Object 指令程式，僅選取 ScriptName 屬性不等於 Null 值的應用程式。如果 ScriptName 屬性不等於 Null 值，則表示指令碼已指派給該應用程式。