Megosztás a következőn keresztül:

Set-Service

  • Referencia
Modul:
Microsoft.PowerShell.Management

Elindítja, leállítja és felfüggeszti a szolgáltatást, és módosítja annak tulajdonságait.

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

A Set-Service parancsmag megváltoztatja egy szolgáltatás tulajdonságait, például az Állapot, a Leírás, a DisplayName és a StartupType tulajdonságot. Set-Service szolgáltatás indítása, leállítása, felfüggesztése vagy szüneteltetése. Egy szolgáltatás azonosításához adja meg a szolgáltatás nevét, vagy küldjön be egy szolgáltatásobjektumot. Vagy küldjön egy szolgáltatásnevet vagy szolgáltatásobjektumot a folyamaton keresztül.Set-Service

Példák

1. példa: Megjelenítendő név módosítása

Ebben a példában egy szolgáltatás megjelenítendő neve módosul. Az eredeti megjelenítendő név megtekintéséhez használja a következőt Get-Service: .

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

Set-ServiceA Név paraméter használatával adja meg a szolgáltatás nevét, a LanmanWorkstationt. A DisplayName paraméter megadja az új megjelenítendő nevet, a LanMan Workstation nevet.

2. példa: A szolgáltatások indítási típusának módosítása

Ez a példa bemutatja, hogyan módosíthatja egy szolgáltatás indítási típusát.

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

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

Set-ServiceA Név paraméter használatával adja meg a szolgáltatás nevét, a BITS-t. A StartupType paraméter automatikusra állítja a szolgáltatást.

Get-ServiceA Név paraméter használatával adja meg a BITS szolgáltatást, és elküldi az objektumot a folyamaton. Select-ObjectA Tulajdonság paraméter használatával jeleníti meg a BITS-szolgáltatás állapotát.

3. példa: Egy szolgáltatás leírásának módosítása

Ez a példa módosítja a BITS szolgáltatás leírását, és megjeleníti az eredményt.

A Get-CimInstance parancsmag azért használatos, mert egy Win32_Service objektumot ad vissza, amely tartalmazza a szolgáltatás leírását.

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 elküldi az objektumot a folyamatnak, Format-List és megjeleníti a szolgáltatás nevét és leírását. Összehasonlítás céljából a parancs a leírás frissítése előtt és után fut.

Set-ServiceA Név paraméter használatával adja meg a BITS szolgáltatást. A Leírás paraméter a szolgáltatások leírásának frissített szövegét adja meg.

4. példa: Szolgáltatás indítása

Ebben a példában egy szolgáltatás indul el.

Set-Service -Name WinRM -Status Running -PassThru

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

Set-ServiceA Név paraméter használatával adja meg a WinRM szolgáltatást. Az Állapot paraméter a Futtatás értékkel indítja el a szolgáltatást. A PassThru paraméter egy ServiceController-objektumot ad ki, amely megjeleníti az eredményeket.

5. példa: Szolgáltatás felfüggesztése

Ez a példa a folyamat használatával szünetelteti a szolgáltatást.

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

Get-ServiceA Név paraméter használatával adja meg az Ütemezés szolgáltatást, és elküldi az objektumot a folyamatba. Set-Serviceaz Állapot paraméterrel állítja be a szolgáltatást Szüneteltetve értékre.

6. példa: Szolgáltatás leállítása

Ez a példa egy változót használ egy szolgáltatás leállításához.

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

Get-ServiceA Név paraméter használatával adja meg az Ütemezés szolgáltatást. Az objektumot a rendszer a változóban tárolja. $S Set-ServiceAz InputObject paramétert használja, és megadja a tárolt $Sobjektumot. Az Állapot paraméter leállítja a szolgáltatást.

7. példa: Több szolgáltatás indítási típusának beállítása

A Set-Service parancsmag egyszerre csak egy szolgáltatásnevet fogad el. A több szolgáltatás konfigurációjának módosításához Set-Service azonban több szolgáltatást is futtathat.

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

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

Paraméterek

-ComputerName

Egy vagy több számítógépet határoz meg. Távoli számítógépek esetén írja be a NetBIOS-nevet, egy IP-címet vagy egy teljes tartománynevet. Ha a ComputerName paraméter nincs megadva, a parancs a helyi számítógépen fut.

Ez a paraméter nem támaszkodik a PowerShell-újraegyezésre. Akkor is használhatja a ComputerName paramétert, ha a számítógép nincs távoli parancsok futtatására konfigurálva.

Típus:String[]
Aliasok:cn
Position:Named
Alapértelmezett érték:Local computer
Kötelező:False
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

-Confirm

Megerősítést kér a futtatás Set-Serviceelőtt.

Típus:SwitchParameter
Aliasok:cf
Position:Named
Alapértelmezett érték:False
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-Description

A szolgáltatás új leírását adja meg.

A szolgáltatás leírása megjelenik a Számítógép-kezelés, Szolgáltatások területen. A Leírás nem a Get-Service ServiceController objektum tulajdonsága. A szolgáltatás leírásának megtekintéséhez használjon Get-CimInstance egy Win32_Service objektumot, amely a szolgáltatást jelöli.

Típus:String
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-DisplayName

A szolgáltatás új megjelenítendő nevét adja meg.

Feljegyzés

Általában csak Windows-szolgáltatásokon működik, Set-Service illesztőprogramok nem. Ha azonban megadja az illesztő nevét, Set-Service meg tudja célozni az illesztőprogramot.

Típus:String
Aliasok:DN
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-InputObject

Egy ServiceController-objektumot ad meg, amely a módosítani kívánt szolgáltatást jelöli. Adjon meg egy változót, amely tartalmazza az objektumot, vagy írjon be egy parancsot vagy kifejezést, amely lekéri az objektumot, például egy parancsot Get-Service . A folyamattal szolgáltatásobjektumot küldhet a rendszernek Set-Service.

Típus:ServiceController
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

-Name

Megadja a módosítani kívánt szolgáltatás szolgáltatásnevét. A helyettesítő karakterek nem engedélyezettek. A folyamat használatával elküldheti a szolgáltatás nevét a következőnek Set-Service: .

Feljegyzés

Általában csak Windows-szolgáltatásokon működik, Set-Service illesztőprogramok nem. Ha azonban megadja az illesztő nevét, Set-Service meg tudja célozni az illesztőprogramot.

Típus:String
Aliasok:ServiceName, SN
Position:0
Alapértelmezett érték:None
Kötelező:True
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

-PassThru

Egy ServiceController-objektumot ad vissza, amely a módosított szolgáltatásokat jelöli. Alapértelmezés szerint Set-Service nem hoz létre kimenetet.

Típus:SwitchParameter
Position:Named
Alapértelmezett érték:False
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-StartupType

Beállítja a szolgáltatás indítási típusát. A paraméter elfogadható értékei a következők:

  • Automatikus – A szolgáltatást az operációs rendszer indítja el vagy indította el a rendszer indításakor. Ha egy automatikusan elindított szolgáltatás egy manuálisan indított szolgáltatástól függ, a manuálisan indított szolgáltatás is automatikusan elindul a rendszer indításakor.
  • Letiltva – A szolgáltatás le van tiltva, és egy felhasználó vagy alkalmazás nem indíthatja el.
  • Manuális – A szolgáltatást csak manuálisan, egy felhasználó, a Service Control Manager vagy egy alkalmazás indítja el.
  • Rendszerindítás – Azt jelzi, hogy a szolgáltatás a rendszerbetöltő által indított eszközillesztő. Ez az érték csak az eszközillesztőkre érvényes.
  • Rendszer – Azt jelzi, hogy a szolgáltatás az "IOInitSystem()" függvény által indított eszközillesztő. Ez az érték csak az eszközillesztőkre érvényes.

Az alapértelmezett érték az Automatikus.

Típus:ServiceStartMode
Aliasok:StartMode, SM, ST
Elfogadott értékek:Boot, System, Automatic, Manual, Disabled
Position:Named
Alapértelmezett érték:Automatic
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-Status

Megadja a szolgáltatás állapotát.

A paraméter elfogadható értékei a következők:

  • Szüneteltetve. Felfüggeszti a szolgáltatást.
  • Fut. Elindítja a szolgáltatást.
  • Leállítva. Leállítja a szolgáltatást.
Típus:String
Elfogadott értékek:Paused, Running, Stopped
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-WhatIf

Megjeleníti, mi történne, ha Set-Service futna. A parancsmag nem fut.

Típus:SwitchParameter
Aliasok:wi
Position:Named
Alapértelmezett érték:False
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

Bevitelek

ServiceController

A szolgáltatásobjektumot erre a parancsmagra csövezheti.

String

Erre a parancsmagra egy szolgáltatásnevet tartalmazó sztringet csövezhet.

Kimenetek

None

Ez a parancsmag alapértelmezés szerint nem ad vissza kimenetet.

ServiceController

A PassThru paraméter használatakor ez a parancsmag egy ServiceController-objektumot ad vissza.

Jegyzetek

Set-Service emelt szintű engedélyeket igényel. Használja a Futtatás rendszergazdaként lehetőséget.

Set-Service csak akkor tudja vezérelni a szolgáltatásokat, ha az aktuális felhasználó rendelkezik a szolgáltatások kezeléséhez szükséges engedélyekkel. Ha egy parancs nem működik megfelelően, előfordulhat, hogy nem rendelkezik a szükséges engedélyekkel.

Ha meg szeretné keresni egy szolgáltatás szolgáltatásnevét vagy megjelenítendő nevét, használja a következőt Get-Service: . A szolgáltatásnevek a Név oszlopban, a megjelenített nevek pedig a DisplayName oszlopban találhatók.