Set-Service

Set-Service
    [-Name] <String>
    [-DisplayName <String>]
    [-Credential <PSCredential>]
    [-Description <String>]
    [-StartupType <ServiceStartupType>]
    [-Status <String>]
    [-SecurityDescriptorSddl <String>]
    [-Force]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Set-Service
    [-InputObject] <ServiceController>
    [-DisplayName <String>]
    [-Credential <PSCredential>]
    [-Description <String>]
    [-StartupType <ServiceStartupType>]
    [-SecurityDescriptorSddl <String>]
    [-Status <String>]
    [-Force]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Dieses Cmdlet ist nur auf der Windows-Plattform verfügbar.

Das cmdlet Set-Service ändert die Eigenschaften eines Diensts wie Status, Description, DisplayNameund StartupType. Set-Service kann einen Dienst starten, beenden, aussetzen oder pausieren. Um einen Dienst zu identifizieren, geben Sie den Dienstnamen ein, oder senden Sie ein Dienstobjekt. Oder senden Sie einen Dienstnamen oder ein Dienstobjekt durch die Pipeline an Set-Service.

In diesem Beispiel wird der Anzeigename eines Diensts geändert. Verwenden Sie Get-Service, um den ursprünglichen Anzeigenamen anzuzeigen.

Set-Service -Name LanmanWorkstation -DisplayName "LanMan Workstation"

Set-Service verwendet den Parameter Name, um den Namen des Diensts anzugeben, LanmanWorkstation. Der parameter DisplayName gibt den neuen Anzeigenamen LanMan Workstationan.

In diesem Beispiel wird gezeigt, wie Sie den Starttyp eines Diensts ändern.

Set-Service -Name BITS -StartupType Automatic
Get-Service BITS | Select-Object -Property Name, StartType, Status

Name  StartType   Status
----  ---------   ------
BITS  Automatic  Running

Set-Service verwendet den Parameter Name, um den Namen des Diensts anzugeben, BITS-. Der parameter StartupType legt den Dienst auf Automaticfest.

Get-Service verwendet den Parameter Name, um den BITS--Dienst anzugeben und das Objekt an die Pipeline zu senden. Select-Object verwendet den Parameter Property, um den Status des BITS Diensts anzuzeigen.

In diesem Beispiel wird die Beschreibung des BITS-Diensts geändert und das Ergebnis angezeigt.

Das cmdlet Get-CimInstance wird verwendet, da es ein Win32_Service-Objekt zurückgibt, das die Descriptiondes Diensts enthält.

Get-CimInstance Win32_Service -Filter 'Name = "BITS"'  | Format-List  Name, Description

Name        : BITS
Description : Transfers files in the background using idle network bandwidth. If the service is
              disabled, then any applications that depend on BITS, such as Windows Update or MSN
              Explorer, will be unable to automatically download programs and other information.

Set-Service -Name BITS -Description "Transfers files in the background using idle network bandwidth."
Get-CimInstance Win32_Service -Filter 'Name = "BITS"' | Format-List  Name, Description

Name        : BITS
Description : Transfers files in the background using idle network bandwidth.

Get-CimInstance sendet das Objekt an Format-List und zeigt den Namen und die Beschreibung des Diensts an. Für Vergleichszwecke wird der Befehl vor und nach der Aktualisierung der Beschreibung ausgeführt.

Set-Service verwendet den Parameter Name, um den BITS--Dienst anzugeben. Der parameter Description gibt den aktualisierten Text für die Beschreibung der Dienste an.

In diesem Beispiel wird ein Dienst gestartet.

Set-Service -Name WinRM -Status Running -PassThru

Status   Name               DisplayName
------   ----               -----------
Running  WinRM              Windows Remote Management (WS-Manag...

Set-Service verwendet den Parameter Name, um den Dienst anzugeben, WinRM-. Der Parameter Status verwendet den Wert Running, um den Dienst zu starten. Der PassThru Parameter gibt ein ServiceController--Objekt aus, das die Ergebnisse anzeigt.

In diesem Beispiel wird die Pipeline verwendet, um für Wartungsarbeiten eine Pause einzulegen.

Get-Service -Name Schedule | Set-Service -Status Paused

Get-Service verwendet den Parameter Name, um den Schedule-Dienst anzugeben und das Objekt an die Pipeline zu senden. Set-Service verwendet den Parameter Status, um den Dienst in den Status Angehaltenzu versetzen.

In diesem Beispiel wird eine Variable verwendet, um einen Dienst zu beenden.

$S = Get-Service -Name Schedule
Set-Service -InputObject $S -Status Stopped

Get-Service verwendet den Parameter Name, um den Dienst anzugeben, Schedule. Das Objekt wird in der Variablen $Sgespeichert. Set-Service verwendet den parameter InputObject und gibt das $Sgespeicherte Objekt an. Der parameter Status legt den Dienst auf Stoppedfest.

In diesem Beispiel wird ein Dienst auf einem Remotecomputer beendet. Weitere Informationen finden Sie unter Invoke-Command.

$Cred = Get-Credential
$S = Get-Service -Name Schedule
Invoke-Command -ComputerName server01.contoso.com -Credential $Cred -ScriptBlock {
  Set-Service -InputObject $S -Status Stopped
}

Get-Credential fordert zur Eingabe eines Benutzernamens und Kennworts auf und speichert die Anmeldeinformationen in der Variable $Cred. Get-Service verwendet den Parameter Name, um den Schedule-Dienst anzugeben. Das Objekt wird in der Variablen $Sgespeichert.

Invoke-Command verwendet den Parameter ComputerName, um einen Remotecomputer anzugeben. Der Parameter Credential verwendet die variable $Cred, um sich beim Computer anzumelden. Der ScriptBlock ruft Set-Service auf. Der parameter InputObject gibt das $Sgespeicherte Dienstobjekt an. Der parameter Status legt den Dienst auf Stoppedfest.

In diesem Beispiel werden die Anmeldeinformationen geändert, die zum Verwalten eines Diensts verwendet werden.

$credential = Get-Credential
Set-Service -Name Schedule -Credential $credential

Get-Credential fordert zur Eingabe eines Benutzernamens und Kennworts auf und speichert die Anmeldeinformationen in der Variable $credential. Set-Service verwendet den Parameter Name, um den Schedule-Dienst anzugeben. Der Parameter Credential verwendet die variable $credential und aktualisiert den Schedule-Dienst.

In diesem Beispiel wird der SecurityDescriptoreines Diensts geändert.

$SDDL = "D:(A;;CCLCSWRPWPDTLOCRRC;;;SY)(A;;CCDCLCSWRPWPDTLOCRSDRCWDWO;;;BA)(A;;CCLCSWLOCRRC;;;SU)"
Set-Service -Name "BITS" -SecurityDescriptorSddl $SDDL

Der SecurityDescriptor- wird in der $SDDL Variablen gespeichert. Set-Service verwendet den Parameter Name, um den BITS--Dienst anzugeben. Der SecurityDescriptorSddl Parameter verwendet $SDDL, um den SecurityDescriptor- für den BITS- Dienst zu ändern.

Das Cmdlet Set-Service akzeptiert jeweils nur einen Dienstnamen. Sie können jedoch mehrere Dienste an Set-Service leiten, um die Konfiguration mehrerer Dienste zu ändern.

Get-Service SQLWriter,spooler |
    Set-Service -StartupType Automatic -PassThru |
    Select-Object Name, StartType

Name      StartType
----      ---------
spooler   Automatic
SQLWriter Automatic

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Sie können ein Dienstobjekt an dieses Cmdlet weiterleiten.

Sie können eine Zeichenfolge, die einen Dienstnamen enthält, an dieses Cmdlet weiterleiten.

Standardmäßig gibt dieses Cmdlet keine Ausgabe zurück.

Wenn Sie den PassThru--Parameter verwenden, gibt dieses Cmdlet ein ServiceController--Objekt zurück.

Dieses Cmdlet ist nur auf Windows-Plattformen verfügbar.

Set-Service erfordert erhöhte Berechtigungen. Verwenden Sie die Option Als Administrator ausführen.

Set-Service kann Dienste nur steuern, wenn der aktuelle Benutzer über Berechtigungen zum Verwalten von Diensten verfügt. Wenn ein Befehl nicht ordnungsgemäß funktioniert, verfügen Sie möglicherweise nicht über die erforderlichen Berechtigungen.

Verwenden Sie Get-Service, um den Dienstnamen oder den Anzeigenamen eines Diensts zu suchen. Die Dienstnamen befinden sich in der Spalte Name, und die Anzeigenamen befinden sich in der Spalte DisplayName.