Get-CsWindowsService
上次修改主題的時間： 2012-03-23
Get-CsWindowsService 會傳回關於當成 Windows 服務執行之 Microsoft Lync Server 2010 元件的詳細資訊。
語法
Get-CsWindowsService [-Name <String>] [-ComputerName <String>] [-ExcludeActivityLevel <SwitchParameter>] [-Report <String>]
詳細描述
許多 Lync Server 2010 元件都會當做標準 Windows 服務執行；例如，Lync Server 會議服務員應用程式實際上是名稱為 RTCCAA 的服務。Get-CsWindowsService 指令程式可讓您擷取關於這些 Lync Server 服務 (而且僅關於這些服務) 的詳細資訊。這是因為此指令程式是針對忽略不屬於 Lync Server 的所有服務而設計。
Get-CsWindowsService 會自動篩選出非 Lync Server 服務，這是這個指令程式所提供的一個優點，表示這個指令程式優於 Windows PowerShell 隨附的一般 Get-Service 指令程式。除此之外，如果您需要擷取 Lync Server 服務的資訊，還有另一個使用 Get-CsWindowsService 的理由：Get-CsWindowsService 會傳回 Get-Service 不傳回的有用資料。例如，傳回關於 Lync Server 會議服務員服務的資訊時，Get-CsWindowsService 會回報此服務 (服務活動層級) 正在處理的同時通話數。Get-Service 則不會。
根據預設，Get-CsWindowsService 針對本機電腦執行。不過，您可以透過加入 -ComputerName 參數來傳回在遠端電腦上執行之 Lync Server 服務的相關資訊。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Get-CsWindowsService Cmdlet：RTCUniversalServerAdmins。此外，您也必須是目的地電腦上 Performance Monitor Users 群組的成員，才能執行這個指令程式。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsWindowsService"}
參數
| 參數 | 必要 | 類型 | 說明 |
|---|---|---|---|
Name |
選用 |
字串 |
您想傳回其資訊的服務名稱。請注意，您必須使用服務名稱 (例如 RTCCAA)，而非服務顯示名稱。您僅能將單一服務名稱傳遞給 Name 參數；此外，您無法在服務名稱中使用萬用字元。 也請注意，Get-CsWindowsService 僅能傳回 Lync Server 服務的資訊；您無法使用這個指令程式傳回其他 Windows 服務的相關資訊。針對那些服務，您或許可以使用 Windows PowerShell Get-Service 指令程式。 如果未加入這個參數，Get-CsWindowsService 將會傳回所有 Lync Server 服務的相關資訊。 |
ComputerName |
選用 |
字串 |
要擷取其服務資訊之遠端電腦的名稱；如果未加入此參數，則 Get-CsWindowsService 將會傳回關於本機電腦上執行之 Lync Server 服務的資訊。您應該使用遠端電腦的完整網域名稱 (FQDN) 來參考它；例如 atl-mcs-001.litwareinc.com。 |
ExcludeActivityLevel |
選用 |
切換參數 |
如果有加入，此參數會使 Get-CsWindowsService 僅傳回服務狀態，而不傳回服務活動層級。 |
Report |
選用 |
字串 |
可儲存錯誤資訊之 HTML 檔案的路徑。如果有加入這個參數，執行此 Cmdlet 期間所發生的任何錯誤都會記錄到指定的檔案 (如 C:\Logs\Service_report.html) 中。 |
輸入類型
無。Get-CsWindowsService 不接受管線傳送的輸入。
傳回類型
Get-CsWindowsService 會傳回 Microsoft.Rtc.Management.Deployment.Core.NTService 物件的執行個體。
範例
-------------------------- 範例 1 ------------------------
Get-CsWindowsService
範例 1 所示的命令會傳回本機電腦上安裝之所有 Lync Server 服務的相關資訊。這可以透過呼叫沒有任何參數的 Get-CsWindowsService 完成。
-------------------------- 範例 2 ------------------------
Get-CsWindowsService | Format-List
範例 2 也會傳回本機電腦上關於 Lync Server 服務的資訊；不過，在此例中，資料會以清單格式顯示 (除此之外，這可讓您檢視每個服務的所有屬性值。在預設的表格式檢視中，只會顯示屬性值的子集)。若要執行此工作，會先呼叫 Get-CsWindowsService，然後會將產生的資訊傳送到 Format-List 指令程式。
-------------------------- 範例 3 ------------------------
Get-CsWindowsService -Name "RTCSrv"
範例 3 會傳回單一 Lync Server 服務的資訊：名稱為 RTCSrv 的服務。
-------------------------- 範例 4 ------------------------
Get-CsWindowsService -Name "RTCSrv" | Select-Object -ExpandProperty RoleName
在範例 4 中，會顯示 RTCSrv 服務所處理之所有服務角色的詳細資訊。若要執行此工作，會先使用 Get-CsWindowsService 傳回關於 RTCSrv 服務的資訊。然後，將此資訊傳送至 Select-Object 指令程式，以使用 ExpandProperty 參數來顯示 RTCSrv 服務所處理的所有角色。請注意，如果服務沒有角色名稱，此命令將會傳回錯誤訊息。
-------------------------- 範例 5 ------------------------
Get-CsWindowsService -Computer atl-cs-001.litwareinc.com
範例 5 所示的命令會傳回遠端電腦 atl-cs-001.litwareinc.com 上已安裝 Lync Server 服務的相關資訊。您可以加入 ComputerName 參數，後面緊接著遠端電腦的 FQDN 來完成這個工作。
-------------------------- 範例 6 ------------------------
Get-CsWindowsService -Report C:\Logs\Services.html
以上的命令會傳回安裝於本機電腦上所有 Lync Server 服務的相關資訊。此外，加入 Report 參數的目的，是為了將錯誤資訊儲存到名稱為 C:\Logs\Services.html 的檔案。如果 Get-CsWindowsService 在擷取服務資料時碰到任何問題，將會在 Services.html 中記錄該問題的相關資訊。
-------------------------- 範例 7 ------------------------
Get-CsWindowsService | Where-Object {$_.Status -eq "Running"}
在範例 7 中，系統僅針對目前正在執行之本機電腦上的 Lync Server 服務，傳回相關資訊。若要完成這個工作，此命令會先呼叫 Get-CsWindowsService 以傳回所有 Lync Server 服務的集合 (不論是否正在執行)。接著，此集合會傳送到 Where-Object 指令程式，只挑出 Status 屬性等於 Running 的服務。
-------------------------- 範例 8 ------------------------
Get-CsWindowsService | Where-Object {$_.DisplayName -like "*Application Sharing*"}
範例 8 示範如何在您不知道該服務的實際名稱時，擷取特定服務的資訊 (在此例中為 RTCASMCU)。若要執行此工作，會先呼叫沒有任何參數的 Get-CsWindowsService，以傳回本機電腦上所有 Lync Server 服務的集合。接著，此集合會傳送到 Where-Object 指令程式，僅選取 DisplayName 屬性包含 (-like) 字串值 "Application Sharing" 的服務。最終結果：會顯示 Lync Server 應用程式共用會議服務的資訊。
-------------------------- 範例 9 ------------------------
Get-CsWindowsService | Where-Object {$_.RoleName -contains "ApplicationServer"}
範例 9 會傳回主控 ApplicationServer 角色之任何服務的相關資訊。若要這樣做，此命令會先呼叫 Get-CsWindowsService 以傳回本機電腦上所有 Lync Server 服務的集合。接著，此集合會傳送到 Where-Object 指令程式，以選取 RoleName 屬性包含 (-contains) ApplicationServer 的服務。