Set-Service

Set-Service
    [-Name] <String>
    [-ComputerName <String[]>]
    [-DisplayName <String>]
    [-Description <String>]
    [-StartupType <ServiceStartMode>]
    [-Status <String>]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Set-Service
    [-ComputerName <String[]>]
    [-DisplayName <String>]
    [-Description <String>]
    [-StartupType <ServiceStartMode>]
    [-Status <String>]
    [-InputObject <ServiceController>]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Polecenie cmdlet Set-Service zmienia właściwości usługi, takie jak Status, Description, DisplayNamei StartupType. Set-Service można uruchomić, zatrzymać, zawiesić lub wstrzymać usługę. Aby zidentyfikować usługę, wprowadź jej nazwę usługi lub prześlij obiekt usługi. Możesz też wysłać nazwę usługi lub obiekt usługi przez potok do Set-Service.

W tym przykładzie nazwa wyświetlana usługi zostanie zmieniona. Aby wyświetlić oryginalną nazwę wyświetlaną, użyj Get-Service.

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

Set-Service używa parametru Name w celu określenia nazwy usługi LanmanWorkstation. Parametr DisplayName określa nową nazwę wyświetlaną LanMan Workstation.

W tym przykładzie pokazano, jak zmienić typ uruchamiania usługi.

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

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

Set-Service używa parametru Name w celu określenia nazwy usługi BITS. Parametr StartupType ustawia usługę na automatyczną.

Get-Service używa parametru Nazwa , aby określić usługę BITS i przesyła obiekt w dół potoku. Select-Object używa właściwości parametru do wyświetlania stanu usługi BITS.

Ten przykład zmienia opis usługi BITS i wyświetla wynik.

Cmdlet Get-CimInstance jest używany, ponieważ zwraca obiekt Win32_Service zawierający opis usługi.

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 wysyła obiekt w dół potoku do Format-List i wyświetla nazwę i opis usługi. W celach porównawczych polecenie jest uruchamiane przed i po zaktualizowaniu opisu.

Set-Service używa parametru Nazwa, aby określić usługę BITS. Parametr Description określa zaktualizowany tekst opisu usług.

W tym przykładzie uruchomiono usługę.

Set-Service -Name WinRM -Status Running -PassThru

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

Set-Service używa parametru Name w celu określenia usługi WinRM. Parametr stanu używa wartości Praca, aby uruchomić usługę. Parametr PassThru zwraca obiekt ServiceController, który wyświetla wyniki.

W tym przykładzie pipeline jest używany do wstrzymania w celu obsługi.

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

Get-Service używa parametru Nazwa, aby określić usługę Schedule i wysyła obiekt w dół potoku. Set-Service używa parametru stanu, aby ustawić usługę na wartość Wstrzymano.

W tym przykładzie użyto zmiennej do zatrzymania usługi.

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

Get-Service używa parametru Nazwa, aby określić usługę, Harmonogram. Obiekt jest przechowywany w zmiennej $S. Set-Service używa parametru InputObject i określa obiekt przechowywany $S. Parametr Status ustawia usługę na Zatrzymano.

Polecenie cmdlet Set-Service akceptuje tylko jedną nazwę usługi jednocześnie. Można jednak przekazać wiele usług do Set-Service, aby zmienić konfigurację wielu usług.

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

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

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

Do tego polecenia cmdlet można przekazać obiekt usługi.

Możesz przekazywać ciąg zawierający nazwę usługi do tego cmdletu.

Domyślnie to polecenie cmdlet nie zwraca żadnych danych wyjściowych.

Jeśli używasz parametru PassThru, to to polecenie cmdlet zwraca obiekt ServiceController.

Set-Service wymaga podniesionych uprawnień. Użyj opcji Uruchom jako administrator.

Set-Service może kontrolować usługi tylko wtedy, gdy bieżący użytkownik ma uprawnienia do zarządzania usługami. Jeśli polecenie nie działa poprawnie, być może nie masz wymaganych uprawnień.

Aby znaleźć nazwę usługi lub nazwę wyświetlaną usługi, użyj Get-Service. Nazwy usług znajdują się w kolumnie Nazwa, a nazwy wyświetlane znajdują się w kolumnie DisplayName.