Set-Service

Reference

Modul:: Microsoft.PowerShell.Management

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

Syntax

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.

Type:	String[]
Aliases:	cn
Position:	Named
Default value:	Local computer
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Confirm

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

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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 objektuGet-Service. Pokud chcete zobrazit popis služby, použijte Get-CimInstance Win32_Service objekt, který představuje službu.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	String
Aliases:	DN
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	ServiceController
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	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.

Type:	String
Aliases:	ServiceName, SN
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	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.

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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á.

Type:	ServiceStartMode
Aliases:	StartMode, SM, ST
Accepted values:	Boot, System, Automatic, Manual, Disabled
Position:	Named
Default value:	Automatic
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	String
Accepted values:	Paused, Running, Stopped
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

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

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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 .

Set-Service

Syntax

Description

Příklady

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

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

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

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

Příklad 5: Pozastavení služby

Příklad 6: Zastavení služby

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

Parametry

-ComputerName

-Confirm

-Description

-DisplayName

-InputObject

-Name

-PassThru

-StartupType

-Status

-WhatIf

Vstupy

Výstupy

Poznámky

Váš názor

Další materiály

Set-Service

Syntax

Description

Příklady

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

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

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

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

Příklad 5: Pozastavení služby

Příklad 6: Zastavení služby

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

Parametry

-ComputerName

-Confirm

-Description

-DisplayName

-InputObject

-Name

-PassThru

-StartupType

-Status

-WhatIf

Vstupy

Výstupy

Poznámky

Související odkazy

Váš názor

Další materiály