Stop-CsWindowsService
Letztes Änderungsdatum des Themas: 2012-03-27
Stop-CsWindowsService ermöglicht Ihnen das Beenden eines Microsoft Lync Server 2010-Diensts.
Syntax
Stop-CsWindowsService [-Name <String>] [-ComputerName <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Graceful <SwitchParameter>] [-NoWait <SwitchParameter>] [-Report <String>] [-WhatIf [<SwitchParameter>]]
Stop-CsWindowsService [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Graceful <SwitchParameter>] [-InputObject <NTService>] [-NoWait <SwitchParameter>] [-Report <String>] [-WhatIf [<SwitchParameter>]]
Detaillierte Beschreibung
Viele Lync Server 2010-Komponenten werden als Standard-Windows-Dienste ausgeführt, z. B. ist die Konferenzzentrale eigentlich ein Dienst namens "RTCCAA". Wenn Sie einen Lync Server-Dienst beenden möchten, können Sie hierfür das Cmdlet Stop-CsWindowsService verwenden.
Beachten Sie, dass mit Stop-CsWindowsService nur Lync Server-Dienste beendet werden können. Wenn Sie versuchen, mit diesem Cmdlet einen anderen Dienst als einen Lync Server-Dienst zu beenden (z. B. den Druckspooler), tritt ein Fehler auf.
In seiner Funktion ähnelt Stop-CsWindowsService dem allgemeinen Windows PowerShell-Cmdlet Stop-Service. Sie könnten auch "Stop-Service" zum Beenden eines Lync Server-Diensts verwenden. Stop-CsWindowsService bietet allerdings den Parameter "ComputerName", der das Beenden eines Diensts auf einem Remotecomputer erleichtert. Geben Sie einfach den Parameter "ComputerName" an, gefolgt vom vollqualifizierten Domänennamen (FQDN, Fully Qualified Domain Name) des Remotecomputers. Das Cmdlet "Stop-Service" besitzt keinen vergleichbaren Parameter. Darüber hinaus umfasst das Cmdlet Stop-CsWindowsService den Parameter "Report", der Ihnen das Speichern eines Protokolls der Fehler, die ggf. beim Aufrufen von Stop-CsWindowsService auftreten, ermöglicht.
Das Cmdlet Stop-CsWindowsService erfüllt genau die Funktion, die der Name vermuten lässt: Es beendet den Dienst, den Sie dafür angeben. Dies schließt auch Dienste mit abhängigen Diensten ein, die nur ausgeführt werden können, wenn der Dienst ausgeführt wird, den Sie beenden möchten. Wenn Sie versuchen, mit Stop-CsWindowsService einen Dienst zu beenden, wird nicht nur der betreffende Dienst, sondern es werden auch alle von diesem Dienst abhängigen Dienste beendet. Da dies unerwartete Folgen haben kann, können Sie beim Aufrufen von Stop-CsWindowsService den Parameter "Graceful" hinzufügen. In diesem Fall hindert Stop-CsWindowsService den Dienst daran, neue Anforderungen zu akzeptieren. Alle vorhandenen Dienstanforderungen bleiben bestehen, neue Anforderungen werden jedoch abgelehnt. Wenn vorhandene Anforderungen abgeschlossen werden, werden diese Anforderungen nicht ersetzt. Schließlich sind alle vorhandenen Anforderungen erfüllt, und der Dienst wird beendet.
Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig dürfen Mitglieder der folgenden Gruppen das Cmdlet Stop-CsWindowsService lokal ausführen: RTCUniversalServerAdmins. Zusätzlich müssen Sie auch lokale Administratorrechte auf dem Zielcomputer besitzen, um dieses Cmdlet ausführen zu können. 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 "Stop-CsWindowsService"}
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
Name |
Optional |
Zeichenfolge |
Name des Lync Server-Diensts, den Sie beenden möchten. 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 und darüber hinaus keine Platzhalter im Dienstnamen verwenden. Mithilfe des Cmdlets Get-CsWindowsService können Sie Dienstnamen abrufen. Beachten Sie außerdem, dass mit Stop-CsWindowsService nur Lync Server-Dienste beendet werden können. Mit diesem Cmdlet können keine anderen Windows-Dienste beendet werden. Für andere Dienste können Sie das Windows PowerShell-Cmdlet Stop-Service einsetzen. |
ComputerName |
Optional |
Zeichenfolge |
Name des Remotecomputers, auf dem der zu beendende Dienst ausgeführt wird. Wenn dieser Parameter nicht verwendet wird, beendet Stop-CsWindowsService die angegebenen Dienste auf dem lokalen Computer. Auf den Remotecomputer muss mit seinem vollqualifizierten Domänennamen (FQDN, Fully Qualified Domain Name) verwiesen werden, z. B. "atl-mcs-001.litwareinc.com". |
Graceful |
Optional |
Switch-Parameter |
Fährt einen Dienst nicht sofort herunter, sondern wartet, bis alle vorhandenen Dienstanforderungen erfüllt sind. (Alle neuen Dienstanforderungen werden jedoch abgelehnt.) Der Dienst wird erst dann vollständig beendet, nachdem alle bestehenden Anforderungen erfüllt wurden. |
InputObject |
Optional |
NTService-Objekt |
Ermöglicht das Beenden eines Diensts mithilfe eines Objektverweises anstelle eines Dienstnamens. Wenn Sie beispielsweise mit Get-CsWindowsService Informationen zu einem Dienst zurückgeben und das zurückgegebene Objekt in der Variablen "$x" speichern, können Sie den Dienst mit dem folgenden Befehl beenden: $x = Get-CsWindowsService –Name "RTCCPS" Stop-CsWindowsService -InputObject $x.Name |
NoWait |
Optional |
Switch-Parameter |
Bei Angabe dieses Parameters wird der Befehl ausgeführt, und die Steuerung wird umgehend an die Windows PowerShell-Eingabeaufforderung zurückgegeben. Andernfalls wird die Steuerung erst zurückgegeben, wenn der Befehl abgeschlossen wurde und auf dem Bildschirm ein Statusbericht angezeigt wird. |
Force |
Optional |
Switch-Parameter |
Unterdrückt die Anzeige von Meldungen bei nicht schwerwiegenden Fehlern, die beim Ausführen des Befehls auftreten können. |
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. |
WhatIf |
Optional |
Switch-Parameter |
Beschreibt die Auswirkungen einer Ausführung des Befehls, ohne den Befehl tatsächlich auszuführen. |
Confirm |
Optional |
Switch-Parameter |
Fordert Sie vor der Ausführung des Befehls zum Bestätigen auf. |
Eingabetypen
Microsoft.Rtc.Management.Deployment.Core.NTService-Objekt. Stop-CsWindowsService akzeptiert weitergeleitete Instanzen des Windows-Dienstobjekts.
Rückgabetypen
Keine. Stattdessen werden mit Stop-CsWindowsService Instanzen des Objekts "Microsoft.Rtc.Management.Deployment.Core.NTService" beendet.
Beispiel
-------------------------- Beispiel 1 --------------------------
Stop-CsWindowsService -Name "RTCRGS"
Mit dem Befehl in Beispiel 1 wird der Dienst der Reaktionsgruppenanwendung auf dem lokalen Computer beendet. Der Dienst der Reaktionsgruppenanwendung wird anhand des Parameters "Name" und des Namens dieses Diensts identifiziert: RTCRGS.
-------------------------- Beispiel 2 ------------------------
Stop-CsWindowsService -Name "RTCRGS" -ComputerName atl-cs-001.litwareinc.com
Der Befehl in Beispiel 2 beendet ebenfalls den Dienst der Reaktionsgruppenanwendung. In diesem Beispiel befindet sich dieser Dienst allerdings auf dem Remotecomputer "atl-cs-001.litwareinc.com". Zum Beenden eines Diensts auf einem Remotecomputer wird der Parameter "ComputerName", gefolgt vom vollqualifizierten Domänennamen des Remotecomputers, verwendet.
-------------------------- Beispiel 3 ------------------------
Get-CsWindowsService | Where-Object {$_.DisplayName -like "*Call Park*"} | Stop-CsWindowsService
Beispiel 3 veranschaulicht, wie Sie einen Dienst beenden können, auch wenn Sie den Namen des Diensts (in diesem Fall RTCCPS) nicht kennen. Hierzu ruft der Befehl zunächst Get-CsWindowsService (ohne weitere Parameter) auf, um eine Auflistung aller Lync Server-Dienste auf dem lokalen Computer zurückzugeben. Diese vollständige Auflistung wird dann an das Cmdlet Where-Object weitergeleitet, das nur die Dienste herausfiltert, deren Eigenschaft "DisplayName" den Zeichenfolgenwert "Call Park" enthält. Die gefilterte Auflistung wird an das Cmdlet Stop-CsWindowsService weitergeleitet, das den Dienst der Anwendung zum Parken von Anrufen beendet.