Set-Service

Modul:

Microsoft.PowerShell.Management Module

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>
    [-DisplayName <String>]
    [-Credential <PSCredential>]
    [-Description <String>]
    [-StartupType <ServiceStartupType>]
    [-Status <String>]
    [-SecurityDescriptorSddl <String>]
    [-Force]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

InputObject

Set-Service
    [-InputObject] <ServiceController>
    [-DisplayName <String>]
    [-Credential <PSCredential>]
    [-Description <String>]
    [-StartupType <ServiceStartupType>]
    [-SecurityDescriptorSddl <String>]
    [-Status <String>]
    [-Force]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Ez a parancsmag csak a Windows platformon érhető el.

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.

7. példa: Szolgáltatás leállítása távoli rendszeren

Ez a példa egy távoli számítógépen leállítja a szolgáltatást. További információért lásd Invoke-Command.

$Cred = Get-Credential
$S = Get-Service -Name Schedule
Invoke-Command -ComputerName server01.contoso.com -Credential $Cred -ScriptBlock {
  Set-Service -InputObject $S -Status Stopped
}

Get-Credential felhasználónevet és jelszót kér, és a hitelesítő adatokat a $Cred változóban tárolja. Get-Service a Név paraméter használatával adja meg a Schedule szolgáltatást. Az objektum az $Sváltozóban van tárolva.

Invoke-Command a ComputerName paraméterrel adja meg a távoli számítógépet. A hitelesítő adat paraméter a $Cred változót használja a számítógépre való bejelentkezéshez. A ScriptBlock meghívja Set-Service. Az InputObject paraméter a $Stárolt szolgáltatásobjektumot adja meg. Az Állapot paraméter a szolgáltatást leállítottállapotra állítja be.

8. példa: Szolgáltatás hitelesítő adatainak módosítása

Ez a példa módosítja a szolgáltatás kezeléséhez használt hitelesítő adatokat.

$credential = Get-Credential
Set-Service -Name Schedule -Credential $credential

Get-Credential felhasználónevet és jelszót kér, és a hitelesítő adatokat a $credential változóban tárolja. Set-Service a Név paraméter használatával adja meg a Schedule szolgáltatást. A Hitelesítő adatok paraméter a $credential változót használja, és frissíti a Schedule szolgáltatást.

9. példa: Egy szolgáltatás SecurityDescriptor-jának módosítása

Ez a példa módosítja a szolgáltatás SecurityDescriptor.

$SDDL = "D:(A;;CCLCSWRPWPDTLOCRRC;;;SY)(A;;CCDCLCSWRPWPDTLOCRSDRCWDWO;;;BA)(A;;CCLCSWLOCRRC;;;SU)"
Set-Service -Name "BITS" -SecurityDescriptorSddl $SDDL

A SecurityDescriptor a $SDDL változóban van tárolva. Set-Service a Név paraméter használatával adja meg a BITS szolgáltatást. A SecurityDescriptorSddl paraméter a $SDDL használatával módosítja a SecurityDescriptor a BITS szolgáltatáshoz.

10. 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. Azonban több szolgáltatást is csatlakoztathat a Set-Service-hoz több szolgáltatás konfigurációjának módosításához.

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

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

Paraméterek

-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

-Credential

A szolgáltatás által szolgáltatás bejelentkezési fiókként használt fiókot adja meg.

Írjon be egy felhasználónevet(például User01 vagy Domain01\User01), vagy írjon be egy PSCredential objektumot, például a Get-Credential parancsmag által létrehozott objektumot. Ha felhasználónevet ír be, ez a parancsmag jelszó megadását kéri.

A hitelesítő adatokat egy PSCredential objektum tárolja, a jelszó pedig SecureString.

Megjegyzés:

További információért a SecureString adatvédelemről lásd: Mennyire biztonságos a SecureString?.

Ezt a paramétert a PowerShell 6.0-ban vezettük be.

Paramétertulajdonságok

Típus:	PSCredential
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

-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.

Megjegyzés:

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

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

-Force

A szolgáltatás leállítási módját adja meg. Ez a paraméter csak -Status Stopped használatakor működik. Ha engedélyezve van, Set-Service leállítja a függő szolgáltatásokat a célszolgáltatás leállítása előtt. Alapértelmezés szerint kivételek akkor merülnek fel, ha más futó szolgáltatások a célszolgáltatástól függenek.

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

-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:	0
Kötelező:	True
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.

Megjegyzés:

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

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

-SecurityDescriptorSddl

A szolgáltatás SecurityDescriptor meghatározása Sddl formátumban történik. Az ezzel a paraméterrel Set-Service híváshoz WRITE_DAC és WRITE_OWNER engedélyekkel kell rendelkeznie. További információ: Szolgáltatásbiztonsági és hozzáférési jogosultságok.

Paramétertulajdonságok

Típus:	String
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False
Aliasok:	Sd

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 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.
• Automatikus késleltetett indítás – Rendszerindítás után röviddel elindul.
• Letiltott – A szolgáltatás le van tiltva, és nem indítható el felhasználó vagy alkalmazás.
• InvalidValue – Nincs hatása. A parancsmag nem ad vissza hibát, de a szolgáltatás StartupType értéke nem módosul.
• Manuális – A szolgáltatást csak manuálisan, egy felhasználó, a Service Control Manager vagy egy alkalmazás indítja el.

Paramétertulajdonságok

Típus:	ServiceStartupType
Alapértelmezett érték:	None
Elfogadott értékek:	Automatic, AutomaticDelayedStart, Disabled, InvalidValue, Manual
Támogatja a helyettesítő karaktereket:	False
DontShow:	False
Aliasok:	StartMode, SM, ST, StartType

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

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

Ez a parancsmag csak Windows-platformokon érhető el.

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.

Kapcsolódó hivatkozások

• Get-Service
• Új szolgáltatás
• Szolgáltatás újraindítása
• Önéletrajz-szolgáltatás
• Start-Service
• Szolgáltatás leállítása
• Szolgáltatás felfüggesztése
• Szolgáltatás eltávolítása