Set-Service
Spustí, zastaví a pozastaví službu a změní její vlastnosti.
Syntaxe
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>]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 pozastavit. 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-Service pomocí parametru Name určuje název 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-Service používá parametr Name k určení názvu služby BITS. Parametr StartupType nastaví službu na Automatické.
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 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.
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...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.
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$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á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 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.
| 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.
| 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, 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.
| 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 do Set-Service.
| 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 negeneruje žá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
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.
| Typ: | ServiceStartMode |
| Aliasy: | StartMode, SM, ST |
| Přípustné hodnoty: | Automatic, Boot, Disabled, Manual, System |
| Position: | Named |
| Default value: | None |
| 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.
- 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 by se stalo, když se Set-Service 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
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 pro Set-Service.
Výstupy
Ve výchozím nastavení Set-Service nevrací žádné objekty. Pomocí parametru PassThru výstupu objektu 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í.
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.