Sdílet prostřednictvím

Set-Service

  • Reference
Modul:
Microsoft.PowerShell.Management

Spustí, zastaví a pozastaví službu a změní její vlastnosti.

Syntaxe

Set-Service
   [-ComputerName <String[]>]
   [-Name] <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>]

Description

Rutina Set-Service změní vlastnosti služby, jako je Status, Description, DisplayName a StartupType. Set-Service může spustit, zastavit, pozastavit nebo pozastavit službu. Pokud chcete identifikovat službu, zadejte její název služby nebo odešlete objekt služby. Nebo odešlete název služby nebo objekt služby v kanálu do Set-Service.

Příklady

Příklad 1: Změna zobrazovaného názvu

V tomto příkladu se změní zobrazovaný název služby. Chcete-li zobrazit původní zobrazovaný název, použijte Get-Service.

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

Set-Servicepoužívá parametr Name k určení názvu služby LanmanWorkstation. Parametr DisplayName určuje nový zobrazovaný název pracovní stanice LanMan.

Příklad 2: Změna typu spouštění služeb

Tento příklad ukazuje, jak změnit typ spuštění služby.

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

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

Set-Servicepoužívá parametr Name k určení názvu služby BITS. Parametr StartupType nastaví službu na Hodnotu Automatic.

Get-Service pomocí parametru Name určí službu BITS a odešle objekt do kanálu. Select-Object pomocí parametru Property zobrazí stav služby BITS .

Příklad 3: Změna popisu služby

Tento příklad změní popis služby BITS a zobrazí výsledek.

Rutina Get-CimInstance se používá, protože vrací objekt Win32_Service, který obsahuje popis služby.

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 odešle objekt do kanálu Format-List a zobrazí název a popis služby. Pro účely porovnání se příkaz spustí před a po aktualizaci popisu.

Set-Servicepoužívá parametr Name k určení služby BITS. Parametr Description určuje aktualizovaný text popisu služby.

Příklad 4: Spuštění služby

V tomto příkladu se spustí služba.

Set-Service -Name WinRM -Status Running -PassThru

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

Set-Servicepoužívá parametr Name k určení služby WinRM. Parametr Status používá hodnotu Spuštěno ke spuštění služby. PassThru parametr výstupu ServiceController objekt, který zobrazí výsledky.

Příklad 5: Pozastavení služby

Tento příklad používá kanál k pozastavení služby.

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

Get-Servicepoužívá parametr Name k určení služby Schedule a odešle objekt dolů kanálu. Set-Service pomocí parametru Status nastaví službu na Pozastaveno.

Příklad 6: Zastavení služby

Tento příklad používá proměnnou k zastavení služby.

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

Get-Servicepoužívá parametr Name k určení služby, Schedule. Objekt je uložen v proměnné, $S. Set-Servicepoužívá inputObject parametr a určuje objekt uložený $S. Parametr Status nastaví službu na Zastaveno.

Příklad 7: Nastavení typu spuštění pro více služeb

Rutina Set-Service přijímá pouze jeden název služby najednou. Pokud ale chcete změnit konfiguraci více služeb, můžete převést více služeb Set-Service .

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

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

Parametry

-ComputerName

Určuje jeden nebo více počítačů. Pro vzdálené počítače zadejte název NetBIOS, IP adresu nebo plně kvalifikovaný název domény. Pokud není zadaný parametr ComputerName, příkaz se spustí na místním počítači.

Tento parametr nespoléhá na vzdálené komunikace PowerShellu. Parametr ComputerName můžete použít i v případě, že váš počítač není nakonfigurovaný tak, aby spouštět vzdálené příkazy.

Typ:String[]
Aliasy:cn
Position:Named
Default value:Local computer
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Confirm

Před spuštěním Set-Servicevás vyzve k potvrzení .

Typ:SwitchParameter
Aliasy:cf
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Description

Určuje nový popis služby.

Popis služby se zobrazí v části Správa počítače, Služby. Popis není vlastnost ServiceController objektu Get-Service . Pokud chcete zobrazit popis služby, použijte Get-CimInstance Win32_Service objekt, který představuje službu.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-DisplayName

Určuje nový zobrazovaný název služby.

Poznámka:

Set-Service Obvykle funguje jenom na službách Systému Windows, nikoli na ovladačích. Pokud však zadáte název ovladače, Set-Service může ovladač cílit.

Typ:String
Aliasy:DN
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-InputObject

Určuje ServiceController objekt, který představuje službu, která se má změnit. Zadejte proměnnou obsahující objekt nebo zadejte příkaz nebo výraz, který objekt získá, například Get-Service příkaz. Kanál můžete použít k odeslání objektu služby do Set-Service.

Typ:ServiceController
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Name

Určuje název služby, která se má změnit. Zástupné znaky nejsou povolené. Kanál můžete použít k odeslání názvu služby .Set-Service

Poznámka:

Set-Service Obvykle funguje jenom na službách Systému Windows, nikoli na ovladačích. Pokud však zadáte název ovladače, Set-Service může ovladač cílit.

Typ:String
Aliasy:ServiceName, SN
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-PassThru

Vrátí ServiceController objekt, který představuje služby, které byly změněny. Ve výchozím nastavení Set-Service nevygeneruje žádný výstup.

Typ:SwitchParameter
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-StartupType

Nastaví typ spuštění služby. Tento parametr přijímá tyto hodnoty:

  • Automaticky – Služba je spuštěna nebo byla spuštěna operačním systémem při spuštění systému. Pokud automaticky spuštěná služba závisí na ručně spuštěné službě, spustí se při spuštění systému automaticky také ručně spuštěná služba.
  • Zakázáno – Služba je zakázaná a uživatel nebo aplikace ji nemůže spustit.
  • Ruční – Služba je spuštěna pouze ručně, uživatelem, pomocí Správce řízení služeb nebo aplikací.
  • Spuštění – Označuje, že služba je ovladač zařízení spuštěný zavaděčem systému. Tato hodnota je platná jenom pro ovladače zařízení.
  • Systém – Označuje, že služba je ovladač zařízení spuštěný funkcí IOInitSystem(). Tato hodnota je platná jenom pro ovladače zařízení.

Výchozí hodnota je Automatická.

Typ:ServiceStartMode
Aliasy:StartMode, SM, ST
Přípustné hodnoty:Boot, System, Automatic, Manual, Disabled
Position:Named
Default value:Automatic
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Status

Určuje stav služby.

Přijatelné hodnoty pro tento parametr jsou následující:

  • Pozastaveno. Pozastaví službu.
  • Běžící (Spuštěno): Spustí službu.
  • Zastaveno: Zastaví službu.
Typ:String
Přípustné hodnoty:Paused, Running, Stopped
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-WhatIf

Ukazuje, co se stane, když Set-Service se spustí. Rutina se nespustí.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Vstupy

ServiceController

Objekt služby můžete do této rutiny převést.

String

Do této rutiny můžete zamísit řetězec, který obsahuje název služby.

Výstupy

None

Ve výchozím nastavení tato rutina nevrací žádný výstup.

ServiceController

Pokud použijete parametr PassThru , vrátí tato rutina objekt ServiceController .

Poznámky

Set-Service vyžaduje zvýšená oprávnění. Použijte možnost Spustit jako správce.

Set-Service může řídit pouze služby, pokud má aktuální uživatel oprávnění ke správě služeb. Pokud příkaz nefunguje správně, možná nemáte požadovaná oprávnění.

Chcete-li najít název služby nebo zobrazovaný název služby, použijte Get-Service. Názvy služeb jsou ve sloupci Název a zobrazované názvy jsou ve sloupci DisplayName .