Start-CsWindowsService
Letztes Änderungsdatum des Themas: 2012-03-27
Start-CsWindowsService ermöglicht Ihnen das Starten eines Microsoft Lync Server 2010-Diensts.
Syntax
Start-CsWindowsService [-Name <String>] [-ComputerName <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-NoWait <SwitchParameter>] [-Report <String>] [-WhatIf [<SwitchParameter>]]
Start-CsWindowsService [-Confirm [<SwitchParameter>]] [-Force <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 einer der Lync Server-Dienste beendet wurde, kann er über das Cmdlet Start-CsWindowsService neu gestartet werden.
Beachten Sie jedoch, dass mit Start-CsWindowsService nur Lync Server-Dienste gestartet werden können. Wenn Sie versuchen, mit diesem Cmdlet einen anderen Dienst als einen Lync Server-Dienst zu starten (z. B. den Druckspooler), tritt ein Fehler auf.
In seiner Funktion ähnelt Start-CsWindowsService dem allgemeinen Windows PowerShell-Cmdlet Start-Service. Sie könnten auch Start-Service zum Starten eines Lync Server-Diensts verwenden. Start-CsWindowsService bietet allerdings den Parameter "ComputerName", der das Starten 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 "Start-Service" besitzt keinen vergleichbaren Parameter. Zusätzlich können über den Parameter "Report" des Cmdlets mögliche Fehler beim Aufruf von Start-CsWindowsService protokolliert werden.
Wie andere Windows-Dienste sind einige Lync Server-Dienste von einem anderen Dienst abhängig. Zum Beispiel kann der Dienst der Lync Server-Konferenzzentrale nur dann ausgeführt werden, wenn der Anwendungsdienst bereits ausgeführt wird. Beim Versuch, einen von einem anderen Dienst abhängigen Dienst zu starten, startet Start-CsWindowsService beide Dienste. Wenn Sie z. B. versuchen, den Dienst der Konferenzzentrale zu starten, startet das Cmdlet zunächst den Anwendungsdienst und anschließend den Dienst der Konferenzzentrale. Abhängige Dienste eines Diensts werden über Start-CsWindowsService jedoch nicht automatisch gestartet: Beim Start des Anwendungsdiensts wird der Dienst der Konferenzzentrale nicht automatisch gestartet.
Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig dürfen Mitglieder der folgenden Gruppen das Cmdlet Start-CsWindows 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 "Start-CsWindowsService"}
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
Name |
Optional |
Zeichenfolge |
Name des Lync Server-Diensts, den Sie starten 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. Dienstnamen können über das Cmdlet Get-CsWindowsService abgerufen werden. Beachten Sie, dass mit Start-CsWindowsService nur Lync Server-Dienste gestartet werden können. Mit diesem Cmdlet können keine anderen Windows-Dienste gestartet werden. Für andere Dienste können Sie das Windows PowerShell-Cmdlet Start-Service einsetzen. |
ComputerName |
Optional |
Zeichenfolge |
Name des Remotecomputers, auf dem der zu startende Dienst gehostet wird. Wenn dieser Parameter nicht aufgenommen wird, startet Start-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-cs-001.litwareinc.com". |
InputObject |
Optional |
NTService-Objekt |
Ermöglicht das Starten eines Diensts unter Verwendung 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 starten: $x = Get-CsWindowsService -Name "RTCCPS" Start-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. Start-CsWindowsService akzeptiert weitergeleitete Instanzen des Windows-Dienstobjekts.
Rückgabetypen
Keine. Stattdessen werden mit Start-CsWindowsService Instanzen des Objekts "Microsoft.Rtc.Management.Deployment.Core.NTService" gestartet.
Beispiel
-------------------------- Beispiel 1 ------------------------
Start-CsWindowsService
Mit dem Befehl in Beispiel 1 werden alle Lync Server-Dienste auf dem lokalen Computer gestartet. Dazu wird Start-CsWindowsService ohne Parameter aufgerufen. Beachten Sie, dass beim Versuch, einen bereits gestarteten Dienst zu starten, kein Fehler zurückgegeben wird.
-------------------------- Beispiel 2 ------------------------
Start-CsWindowsService -Name "RTCRGS"
Mit dem vorstehenden Befehl wird der Dienst der Reaktionsgruppenanwendung auf dem lokalen Computer gestartet. Zu diesem Zweck verwendet der Befehl den Parameter "Name", auf den der Dienstname folgt: RTCRGS.
-------------------------- Beispiel 3 ------------------------
Start-CsWindowsService -Name "RTCRGS" -ComputerName atl-cs-001.litwareinc.com
Über den Befehl in Beispiel 3 wird der Dienst der Reaktionsgruppenanwendung ebenfalls gestartet. In diesem Fall wird der Dienst jedoch auf dem Remotecomputer "atl-cs-001.litwareinc.com" gestartet. Zum Starten eines Diensts auf einem Remotecomputer wird der Parameter "ComputerName", gefolgt vom vollqualifizierten Domänennamen des Remotecomputers, verwendet.
-------------------------- Beispiel 4 ------------------------
Get-CsWindowsService | Where-Object {$_.Status -ne "Running"} | Start-CsWindowsService
In Beispiel 4 durchsucht der Befehl den lokalen Computer nach allen Lync Server-Diensten, die gegenwärtig nicht ausgeführt werden. Anschließend werden alle inaktiven Dienste gestartet. Hierzu ruft der Befehl zunächst Get-CsWindowsService auf, um eine Auflistung aller Lync Server-Dienste zurückzugeben. Diese Auflistung wird dann an das Cmdlet Where-Object weitergeleitet, das die Dienste herausfiltert, bei denen die Eigenschaft "Status" nicht den Wert "Running" aufweist. Diese gefilterte Auflistung wird anschließend an das Cmdlet Start-CsWindowsService weitergeleitet, das jeden Dienst in der Auflistung startet.