Set-Service
Spustí, zastaví a pozastaví službu a změní její vlastnosti.
Syntax
Name (Výchozí)
Set-Service
[-Name] <String>
[-ComputerName <String[]>]
[-DisplayName <String>]
[-Description <String>]
[-StartupType <ServiceStartMode>]
[-Status <String>]
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
InputObject
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 Stav, Popis, DisplayNamea StartupType.
Set-Service může službu spustit, zastavit, pozastavit nebo přerušit. 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 po 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-Service pomocí parametru Name určuje název služby LanmanWorkstation. Parametr DisplayName určuje nový zobrazovaný název, LanMan pracovní stanice.
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-Service používá parametr Name k určení názvu služby BITS. Parametr StartupType nastaví službu na Automatické.
Get-Service pomocí parametru Name určí službu BITS a odešle objekt do potrubí.
Select-Object používá parametr vlastnosti ke zobrazení stavu služby BITS.
Příklad 3: Změna popisu služby
Tento příklad změní popis služby BITS a zobrazí výsledek.
Cmdlet Get-CimInstance je používán, 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 skrz potrubí do 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-Service používá parametr Name k určení služby BITS. Parametr Description určuje aktualizovaný text popisu služeb.
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-Service používá parametr název k určení služby WinRM. Parametr Stav používá hodnotu Spuštěno ke spuštění služby. Parametr PassThru generuje objekt ServiceController, který zobrazuje 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-Service pomocí parametru Name určí službu Schedule a odešle objekt do kanálu.
Set-Service pomocí parametru stavu 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-Service používá parametr název k určení služby, harmonogram . Objekt je uložen v proměnné $S.
Set-Service používá parametr InputObject a určuje objekt uložený $S. Parametr Stav nastaví službu na Zastaveno.
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álenou komunikaci 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.
Vlastnosti parametru
| Typ: | String[] |
| Default value: | Local computer |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | cn |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-Confirm
Před spuštěním Set-Servicevás vyzve k potvrzení.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | False |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | viz |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-Description
Určuje nový popis služby.
Popis služby se zobrazí v Správa počítače, Služby. Popis není vlastností objektu Get-ServiceServiceController. Pokud chcete zobrazit popis služby, použijte Get-CimInstance, který vrací Win32_Service objekt, který představuje službu.
Vlastnosti parametru
| Typ: | String |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-DisplayName
Určuje nový zobrazovaný název služby.
Vlastnosti parametru
| Typ: | String |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | DN |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-InputObject
Určuje ServiceController objekt, který představuje službu, která se má změnit. Zadejte proměnnou, která obsahuje objekt, nebo zadejte příkaz nebo výraz, který objekt získá, například příkaz Get-Service. Kanál můžete použít k odeslání objektu služby do Set-Service.
Vlastnosti parametru
| Typ: | ServiceController |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
InputObject
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | True |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | 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 do Set-Service.
Vlastnosti parametru
| Typ: | String |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | Název služby, SN |
Sady parametrů
Name
| Position: | 0 |
| Povinné: | True |
| Hodnota z kanálu: | True |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-PassThru
Vrátí ServiceController objekt, který představuje služby, které byly změněny. Ve výchozím nastavení Set-Service negeneruje žádný výstup.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | False |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-StartupType
Určuje režim spuštění služby.
Přijatelné hodnoty pro tento parametr jsou následující:
- Automatické. Spustí se při spuštění systému.
- Zakázáno. Službu nejde spustit.
- Ruční. Spustí se pouze při spuštění uživatelem nebo programem.
Vlastnosti parametru
| Typ: | ServiceStartMode |
| Default value: | None |
| Přípustné hodnoty: | Automatic, Boot, Disabled, Manual, System |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | StartMode, SM, ST |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-Status
Určuje stav služby.
Přijatelné hodnoty pro tento parametr jsou následující:
- Pozastaveno. Pozastaví službu.
- Běží. Spustí službu.
- bylo zastaveno. Zastaví službu.
Vlastnosti parametru
| Typ: | String |
| Default value: | None |
| Přípustné hodnoty: | Paused, Running, Stopped |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-WhatIf
Ukazuje, co by se stalo, když se Set-Service spustí. Cmdlet se nespustil.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | False |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | Wi |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
CommonParameters
Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.
Vstupy
System.ServiceProcess.ServiceController, System.String
Kanál můžete použít k odeslání objektu služby nebo řetězce, který obsahuje název služby do Set-Service.
Výstupy
ServiceController
Ve výchozím nastavení nevrací žádné objekty. Set-Service K výstupu objektu ServiceController použijte parametr PassThru.
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í.
Pokud chcete 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.