New-Service
Létrehoz egy új Windows-szolgáltatást.
Syntax
Default (Alapértelmezett)
New-Service
[-Name] <String>
[-BinaryPathName] <String>
[-DisplayName <String>]
[-Description <String>]
[-StartupType <ServiceStartMode>]
[-Credential <PSCredential>]
[-DependsOn <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
A New-Service parancsmag létrehoz egy új bejegyzést egy Windows-szolgáltatáshoz a beállításjegyzékben és a szolgáltatásadatbázisban. Egy új szolgáltatáshoz egy végrehajtható fájlra van szükség, amely a szolgáltatás során fut.
A parancsmag paraméterei lehetővé teszik a szolgáltatás megjelenítendő nevének, leírásának, indítási típusának és függőségeinek beállítását.
Példák
1. példa: Szolgáltatás létrehozása
PS C:\> New-Service -Name "TestService" -BinaryPathName "C:\WINDOWS\System32\svchost.exe -k netsvcs"
Ez a parancs létrehoz egy TestService nevű szolgáltatást.
2. példa: Leírást, indítási típust és megjelenítendő nevet tartalmazó szolgáltatás létrehozása
PS C:\> New-Service -Name "TestService" -BinaryPathName "C:\WINDOWS\System32\svchost.exe -k netsvcs" -DependsOn NetLogon -DisplayName "Test Service" -StartupType Manual -Description "This is a test service."
Ez a parancs létrehoz egy TestService nevű szolgáltatást. A New-Service paramétereit használja az új szolgáltatás leírásának, indítási típusának és megjelenítendő nevének megadásához.
3. példa: Az új szolgáltatás megtekintése
PS C:\> Get-WmiObject win32_service -Filter "name='testservice'"
ExitCode : 0
Name : testservice
ProcessId : 0
StartMode : Auto
State : Stopped
Status : OK
Ez a parancs Get-WmiObject használatával lekéri az új szolgáltatás Win32_Service objektumát. Ez az objektum tartalmazza a kezdési módot és a szolgáltatás leírását.
4. példa: Szolgáltatás törlése
PS C:\> sc.exe delete TestService
- or -
PS C:\> (Get-WmiObject win32_service -Filter "name='TestService'").delete()
Ez a példa a TestService szolgáltatás törlésének két módját mutatja be.
Az első parancs a Sc.exetörlési beállítását használja.
A második parancs a Get-WmiObject által visszaadott Win32_Service objektumok
Paraméterek
-BinaryPathName
A szolgáltatás végrehajtható fájljának elérési útját adja meg. Ez a paraméter kötelező.
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: | 1 |
| Kötelező: | True |
| 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 |
-Confirm
Megerősítést kér a parancsmag futtatá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.
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 |
-DependsOn
Megadja azoknak a szolgáltatásoknak a nevét, amelyektől az új szolgáltatás függ. Több szolgáltatásnév megadásához használjon vesszőt a nevek elválasztásához.
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 |
-Description
A szolgáltatás leírását adja meg.
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 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 |
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 |
-Name
Megadja a szolgáltatás nevét. Ez a paraméter kötelező.
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 |
Paraméterkészletek
(All)
| Position: | 0 |
| Kötelező: | True |
| 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
Beállítja a szolgáltatás indítási típusát. A paraméter elfogadható értékei a következők:
- Kézikönyv. A szolgáltatást csak manuálisan, egy felhasználó, a Service Control Manager vagy egy alkalmazás indítja el.
- Automatikus. A szolgáltatást az operációs rendszer indította 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.
- Fogyatékos. A szolgáltatás le van tiltva, és egy felhasználó vagy alkalmazás nem indíthatja el.
Az alapértelmezett érték az Automatikus.
Paramétertulajdonságok
| Típus: | ServiceStartMode |
| Alapértelmezett érték: | None |
| Elfogadott értékek: | Automatic, Manual, Disabled |
| 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 a parancsmag futna. A parancsmag nem fut.
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
None
Ehhez a parancsmaghoz nem csövezhet be bemenetet.
Kimenetek
ServiceController
Ez a parancsmag egy objektumot ad vissza, amely az új szolgáltatást jelöli.
Jegyzetek
- A parancsmag Windows Vista és a Windows operációs rendszer újabb verzióiban való futtatásához indítsa el a Windows PowerShellt a Futtatás rendszergazdaként lehetőséggel.
- Szolgáltatás törléséhez használja a Sc.exe, vagy használja a Get-WmiObject parancsmagot a szolgáltatást jelképező Win32_Service objektum lekéréséhez, majd a szolgáltatás törléséhez használja a Törlés metódust. A Get-Service visszaadott objektum nem rendelkezik törlési módszerrel.