Set-Service
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-Service
A 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-Service
A 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-Service
A Név paraméter használatával adja meg a BITS szolgáltatást, és elküldi az objektumot a folyamaton. Select-Object
A 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-Service
A 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-Service
A 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-Service
A Név paraméter használatával adja meg az Ütemezés szolgáltatást, és elküldi az objektumot a folyamatba. Set-Service
az Á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-Service
A 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-Service
Az InputObject paramétert használja, és megadja a tárolt $S
objektumot. 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.
Type: | String[] |
Aliases: | cn |
Position: | Named |
Default value: | Local computer |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Confirm
Megerősítést kér a futtatás Set-Service
előtt.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | String |
Aliases: | DN |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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
.
Type: | ServiceController |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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.
Type: | String |
Aliases: | ServiceName, SN |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | 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.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
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
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.
Type: | String |
Accepted values: | Paused, Running, Stopped |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Megjeleníti, mi történne, ha Set-Service
futna. A parancsmag nem fut.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Bevitelek
A szolgáltatásobjektumot erre a parancsmagra csövezheti.
Erre a parancsmagra egy szolgáltatásnevet tartalmazó sztringet csövezhet.
Kimenetek
None
Ez a parancsmag alapértelmezés szerint nem ad vissza kimenetet.
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.
Kapcsolódó hivatkozások
Visszajelzés
https://aka.ms/ContentUserFeedback.
Hamarosan elérhető: 2024-ben fokozatosan kivezetjük a GitHub-problémákat a tartalom visszajelzési mechanizmusaként, és lecseréljük egy új visszajelzési rendszerre. További információ:Visszajelzés küldése és megtekintése a következőhöz: