Get-CsWindowsService
Letztes Änderungsdatum des Themas: 2012-03-23
Get-CsWindowsService gibt ausführliche Informationen zu den Microsoft Lync Server 2010-Komponenten zurück, die als Windows-Dienste ausgeführt werden.
Syntax
Get-CsWindowsService [-Name <String>] [-ComputerName <String>] [-ExcludeActivityLevel <SwitchParameter>] [-Report <String>]
Detaillierte Beschreibung
Viele Lync Server 2010-Komponenten werden als standardmäßige Windows-Dienste ausgeführt, z. B. ist Lync Server Konferenzzentrale der Dienst "RTCCAA". Mit dem Cmdlet Get-CsWindowsService können Sie ausführliche Informationen zu ausschließlich diesen Lync Server-Diensten abrufen. Dies liegt daran, dass das Cmdlet alle Dienste ignoriert, die nicht zu Lync Server gehören.
Da Get-CsWindowsService andere Dienste als Lync Server-Dienste automatisch herausfiltert, ist dies ein Vorteil des Cmdlets gegenüber dem allgemeinen Cmdlet Get-Service, das als Teil von Windows PowerShell bereitgestellt wird. Darüber hinaus gibt es einen weiteren Grund, Get-CsWindowsService zu verwenden, wenn Sie Informationen für einen Lync Server-Dienst abrufen müssen: Get-CsWindowsService gibt hilfreiche Daten zurück, die Get-Service nicht zurückgibt. Get-CsWindowsService gibt z. B. beim Zurückgeben von Informationen zum Dienst "Lync Server-Konferenzzentrale" die Anzahl gleichzeitiger Anrufe zurück, die vom Dienst verarbeitet werden (Dienstaktivitätsgrad). Bei Get-Service ist dies nicht der Fall.
Get-CsWindowsService wird standardmäßig für den lokalen Computer ausgeführt. Wenn Sie den Parameter "ComputerName" verwenden, können Sie jedoch Informationen zu den Lync Server-Diensten zurückgeben, die auf einem Remotecomputer ausgeführt werden.
Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig sind Mitglieder der folgenden Gruppen autorisiert, das Cmdlet Get-CsWindowsService lokal auszuführen: RTCUniversalServerAdmins. Darüber hinaus müssen Sie zum Ausführung dieses Cmdlets Mitglied der Gruppe "Leistungsüberwachungsbenutzer" auf dem Zielcomputer sein. Geben Sie den folgenden Befehl an der Windows PowerShell-Eingabeaufforderung ein, um eine Liste aller rollenbasierten Zugriffssteuerungsrollen zurückzugeben, die diesem Cmdlet zugewiesen wurden (einschließlich der benutzerdefinierten rollenbasierten Zugriffssteuerungsrollen, die Sie selbst erstellt haben):
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsWindowsService"}
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
Name |
Optional |
Zeichenfolge |
Name des Diensts, für den Informationen zurückgegeben werden sollen. Beachten Sie, dass Sie den Dienstnamen (z. B. RTCCAA) und nicht den Anzeigenamen des Diensts verwenden müssen. Sie können an den Parameter "Name" nur einen Dienstnamen übergeben. Sie können darüber hinaus keine Platzhalter im Dienstnamen verwenden. Beachten Sie außerdem, dass Get-CsWindowsService nur Informationen zu Lync Server-Diensten zurückgeben kann. Mit diesem Cmdlet können Sie keine Informationen zu anderen Windows-Diensten zurückgeben. Sie können für diese Dienste das Windows PowerShell-Cmdlet Get-Service verwenden. Wenn Sie diesen Parameter nicht verwenden, gibt Get-CsWindowsService Informationen zu allen Lync Server-Diensten zurück. |
ComputerName |
Optional |
Zeichenfolge |
Name des Remotecomputers, von dem die Dienstinformationen abgerufen werden. Wenn dieser Parameter nicht verwendet wird, gibt Get-CsWindowsService Informationen zu den Lync Server-Diensten zurück, die auf dem lokalen Computer ausgeführt werden. Auf den Remotecomputer muss mit seinem vollqualifizierten Domänennamen verwiesen werden, z. B. "atl-mcs-001.litwareinc.com". |
ExcludeActivityLevel |
Optional |
Switch-Parameter |
Wenn dieser Parameter verwendet wird, gibt Get-CsWindowsService nur den Dienststatus und nicht den Dienstaktivitätsgrad zurück. |
Report |
Optional |
Zeichenfolge |
Pfad zu einer HTML-Datei, in der Fehlerinformationen gespeichert werden können. Wenn dieser Parameter verwendet wird, werden alle Fehler, die während der Ausführung dieses Cmdlets auftreten, in der angegebenen Datei (z. B. "C:\Logs\Service_report.html") protokolliert. |
Eingabetypen
Keine. Get-CsWindowsService akzeptiert keine weitergeleitete Eingabe.
Rückgabetypen
Mit Get-CsWindowsService werden Instanzen des Objekts "Microsoft.Rtc.Management.Deployment.Core.NTService" zurückgegeben.
Beispiel
-------------------------- Beispiel 1 ------------------------
Get-CsWindowsService
Der Befehl in Beispiel 1 gibt Informationen zu allen Lync Server-Diensten zurück, die auf dem lokalen Computer ausgeführt werden. Dazu wird Get-CsWindowsService ohne Parameter aufgerufen.
-------------------------- Beispiel 2 ------------------------
Get-CsWindowsService | Format-List
Beispiel 2 gibt ebenfalls Informationen zu den Lync Server-Diensten auf dem lokalen Computer zurück. Die Daten werden in diesem Fall jedoch im Listenformat angezeigt. (Unter anderem können Sie alle Eigenschaftswerte für jeden Dienst anzeigen. In der Tabellenansicht wird standardmäßig nur eine Teilmenge der Eigenschaftswerte angezeigt.) Hierzu ruft der Befehl zunächst Get-CsWindowsService auf. Diese Informationen werden dann an das Cmdlet Format-List weitergeleitet.
-------------------------- Beispiel 3 ------------------------
Get-CsWindowsService -Name "RTCSrv"
Mit Beispiel 3 werden Informationen zu einem einzelnen Lync Server-Dienst zurückgegeben: dem Dienst "RTCSrv".
-------------------------- Beispiel 4 ------------------------
Get-CsWindowsService -Name "RTCSrv" | Select-Object -ExpandProperty RoleName
In Beispiel 4 werden ausführliche Informationen für alle Dienstrollen angezeigt, die vom Dienst "RTCSrv" geändert werden. Hierzu wird Get-CsWindowsService zunächst verwendet, um Informationen zum Dienst "RTCSrv" zurückzugeben. Diese Informationen werden anschließend an das Cmdlet Select-Object weitergeleitet, das den Parameter "ExpandProperty" verwendet, um alle vom Dienst "RTCSrv" verwendeten Rollen anzuzeigen. Beachten Sie, dass mit diesem Befehl eine Fehlermeldung zurückgegeben wird, wenn ein Dienst keinen Rollennamen hat.
-------------------------- Beispiel 5 ------------------------
Get-CsWindowsService -Computer atl-cs-001.litwareinc.com
Der Befehl in Beispiel 5 gibt Informationen zu den Lync Server-Diensten auf dem Remotecomputer "atl-cs-001.litwareinc.com" zurück. Dazu wird der Parameter "ComputerName" gefolgt vom vollqualifizierten Domänennamen des Remotecomputers verwendet.
-------------------------- Beispiel 6 ------------------------
Get-CsWindowsService -Report C:\Logs\Services.html
Mit dem vorstehenden Befehl werden Informationen zu allen Lync Server-Diensten auf dem lokalen Computer zurückgegeben. Es wird außerdem der Parameter "Report" verwendet, um Fehlerinformationen in die Datei "C:\Services.html" zu speichern. Wenn Get-CsWindowsService beim Abrufen von Dienstdaten Probleme feststellt, werden Informationen zu diesem Problem in "Services.html" aufgezeichnet.
-------------------------- Beispiel 7 --------------------------
Get-CsWindowsService | Where-Object {$_.Status -eq "Running"}
In Beispiel 7 werden nur Informationen für die Lync Server-Dienste auf dem derzeit ausgeführten lokalen Computer zurückgegeben. Hierzu ruft der Befehl zunächst Get-CsWindowsService auf, um eine Auflistung aller Lync Server-Dienste zurückzugeben, die ausgeführt oder nicht ausgeführt werden. Diese Auflistung wird an das Cmdlet Where-Object weitergeleitet, das die Dienste herausfiltert, bei denen die Eigenschaft "Status" den Wert "Running" aufweist.
-------------------------- Beispiel 8 --------------------------
Get-CsWindowsService | Where-Object {$_.DisplayName -like "*Application Sharing*"}
In Beispiel 8 wird dargestellt, wie Sie Informationen für einen bestimmten Dienst abrufen können, wenn Sie den tatsächlichen Namen des Diensts (in diesem Fall "RTCASMCU") nicht kennen. Hierzu wird Get-CsWindowsService zunächst ohne Parameter aufgerufen. Anschließend wird eine Auflistung aller Lync Server-Dienste auf dem lokalen Computer zurückgegeben. Diese Auflistung wird dann an das Cmdlet Where-Object weitergeleitet, das nur den Dienst herausfiltert, dessen Eigenschaft "DisplayName" den Zeichenfolgenwert "Application Sharing" verwendet (-like). Das Ergebnis: Für den Lync Server Konferenzdienst zur Anwendungsfreigabe werden Informationen angezeigt.
-------------------------- Beispiel 9 --------------------------
Get-CsWindowsService | Where-Object {$_.RoleName -contains "ApplicationServer"}
In Beispiel 9 werden Informationen zu Diensten zurückgegeben, die die Rolle "ApplicationServer" hosten. Hierzu ruft der Befehl zunächst Get-CsWindowsService auf, um eine Auflistung aller Lync Server-Dienste auf dem lokalen Computer zurückzugeben. Diese Auflistung wird dann an das Cmdlet Where-Object weitergeleitet, das nur die Dienste herausfiltert, bei denen die Eigenschaft "RoleName" die Rolle "ApplicationServer" verwendet (-contains).