Set-Service
Elindítja, leállítja és felfüggeszti a szolgáltatást, és módosítja annak tulajdonságait.
Syntax
Name (Alapértelmezett)
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
A Set-Service parancsmag megváltoztatja egy szolgáltatás tulajdonságait, például az Állapot, Leírás, DisplayNameés StartupType.
Set-Service elindíthat, leállíthat, felfüggeszthet vagy szüneteltethet egy szolgáltatást. 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 Set-Servicecsatornáján keresztül.
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 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, LanmanWorkstation. A DisplayName paraméter adja meg az új megjelenítendő nevet, LanMan Workstation.
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, BITS. Az StartupType paraméter a szolgáltatást Automatikusmódba állítja be.
Get-Service a Name paraméterrel határozza meg a BITS szolgáltatást, és elküldi az objektumot a csővezetéken keresztül.
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.
Azért használja a Get-CimInstance parancsmagot, mert visszaad egy Win32_Service objektumot, 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 folyamaton keresztül a Format-List-re, é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 Description paraméter határozza meg a szolgáltatások leírásának frissített szövegét.
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 Name paramétert használja a szolgáltatás megadásához, WinRM. Az Állapot paraméter a szolgáltatás indításához a Futó értéket használja. 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 Name paramétert használja a Schedule szolgáltatás megadásához, és elküldi az objektumot a folyamaton.
Set-Service a Állapot paraméterrel állítja be a szolgáltatást Szüneteltetettállapotba.
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étert használja a szolgáltatás megadásához, Ütemezés. Az objektum az $Sváltozóban van tárolva.
Set-Service az InputObject paramétert használja, és megadja a $Stárolt objektumot. Az Állapot paraméter a szolgáltatást leállítottállapotra állítja be.
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 távoli elérésre. A ComputerName paramétert akkor is használhatja, ha a számítógép nincs távoli parancsok futtatására konfigurálva.
Paramétertulajdonságok
| Típus: | String[] |
| Alapértelmezett érték: | Local computer |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | Kína |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | True |
| Fennmaradó argumentumokból származó érték: | False |
-Confirm
Megerősítést kér a Set-Servicefuttatása előtt.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | False |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | Cf |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | 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épkezelés, Szolgáltatásokrészben. A Leírás nem a Get-ServiceServiceController objektum tulajdonsága. A szolgáltatás leírásának megtekintéséhez használja az Get-CimInstance, amely egy Win32_Service objektumot ad vissza, amely a szolgáltatást jelöli.
Paramétertulajdonságok
| Típus: | String |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-DisplayName
A szolgáltatás új megjelenítendő nevét adja meg.
Paramétertulajdonságok
| Típus: | String |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | DN |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | 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 Get-Service parancsot. A pipeline használatával szolgáltatásobjektumot küldhet Set-Service-ra.
Paramétertulajdonságok
| Típus: | ServiceController |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
InputObject
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | True |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | 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 csatorna használatával elküldheti a szolgáltatás nevét Set-Service.
Paramétertulajdonságok
| Típus: | String |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | Szolgáltatás neve, SN |
Paraméterkészletek
Name
| Position: | 0 |
| Kötelező: | True |
| Folyamatból származó érték: | True |
| Folyamatból származó érték tulajdonságnév alapján: | True |
| Fennmaradó argumentumokból származó érték: | 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.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | False |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-StartupType
A szolgáltatás indítási módját adja meg.
A paraméter elfogadható értékei a következők:
- Automatikus. A rendszer indításakor indul el.
- Letiltva. A szolgáltatás nem indítható el.
- Kézikönyv. Csak akkor indul el, ha egy felhasználó vagy program elindítja.
Paramétertulajdonságok
| Típus: | ServiceStartMode |
| Alapértelmezett érték: | None |
| Elfogadott értékek: | Automatic, Boot, Disabled, Manual, System |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | StartMode, SM, ST |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Status
Megadja a szolgáltatás állapotát.
A paraméter elfogadható értékei a következők:
- Szüneteltetett. Felfüggeszti a szolgáltatást.
- Futó. Elindítja a szolgáltatást.
- leállított. Leállítja a szolgáltatást.
Paramétertulajdonságok
| Típus: | String |
| Alapértelmezett érték: | None |
| Elfogadott értékek: | Paused, Running, Stopped |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-WhatIf
Megjeleníti, mi történne, ha Set-Service futna. A parancsprogram nem lett futtatva.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | False |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | Wi |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
CommonParameters
Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.
Bevitelek
System.ServiceProcess.ServiceController, System.String
A folyamat használatával elküldhet egy szolgáltatásobjektumot vagy egy szolgáltatásnevet Set-Servicetartalmazó sztringet.
Kimenetek
ServiceController
Alapértelmezés szerint Set-Service nem ad vissza objektumokat. A PassThru paraméterrel egy ServiceController objektumot adhat ki.
Jegyzetek
Set-Service emelt szintű engedélyeket igényel. Használja a Rendszergazdaként futtatás lehetőséget.
Set-Service csak akkor szabályozhatja 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.
A szolgáltatás szolgáltatásnevének vagy megjelenítendő nevének megkereséséhez használja a Get-Service. A szolgáltatásnevek a Név oszlopban, a megjelenítendő nevek pedig a DisplayName oszlopban találhatók.