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

New-Service

  • Referencia
Modul:
Microsoft.PowerShell.Management

Létrehoz egy új Windows-szolgáltatást.

Syntax

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

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

$params = @{
  Name = "TestService"
  BinaryPathName = 'C:\WINDOWS\System32\svchost.exe -k netsvcs'
  DependsOn = "NetLogon"
  DisplayName = "Test Service"
  StartupType = "Manual"
  Description = "This is a test service."
}
New-Service @params

Ez a parancs létrehoz egy TestService nevű szolgáltatást. A paraméterekkel New-Service adja meg az új szolgáltatás leírását, indítási típusát és megjelenítendő nevét.

3. példa: Az új szolgáltatás megtekintése

Get-CimInstance -ClassName Win32_Service -Filter "Name='testservice'"

ExitCode  : 0
Name      : testservice
ProcessId : 0
StartMode : Auto
State     : Stopped
Status    : OK

Ez a parancs az új szolgáltatás Win32_Service objektumának lekérésére szolgálGet-CimInstance. 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

sc.exe delete TestService
# - or -
(Get-CimInstance -Class 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 törlési lehetőséget Sc.exehasználja. A második parancs a visszaadott Win32_Service objektumok Get-CimInstance Törlés metódusát használja.

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

A szolgáltatás bináris fájljának teljes elérési útja. Ha az elérési út szóközt tartalmaz, a helyes értelmezéshez idézni kell. Például meg kell adni a d:\my share\myservice.exe következőt: '"d:\my share\myservice.exe"'.

Az elérési út az automatikus indítási szolgáltatás argumentumait is tartalmazhatja. Például: '"d:\my share\myservice.exe" arg1 arg2'. Ezeket az argumentumokat a rendszer átadja a szolgáltatás belépési pontjának.

További információt a CreateServiceW API lpBinaryPathName paraméterében talál.

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Jóváhagyást kér a parancsmag futtatása előtt.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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 parancsmag által Get-Credential létrehozott objektumot. Ha felhasználónevet ír be, ez a parancsmag jelszó megadását kéri.

A hitelesítő adatokat PSCredential objektum tárolja, a jelszót pedig SecureStringként tárolja a rendszer.

Feljegyzés

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

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Description

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisplayName

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Megadja a szolgáltatás nevét. Ez a paraméter kötelező.

Type:String
Aliases:ServiceName
Position:0
Default value:None
Required:True
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
Accepted values:Boot, System, Automatic, Manual, Disabled
Position:Named
Default value:Automatic
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Bemutatja, mi történne a parancsmag futtatásakor. A parancsmag nem fut.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Bevitelek

None

Ehhez a parancsmaghoz nem lehet objektumokat csövezni.

Kimenetek

ServiceController

Ez a parancsmag az új szolgáltatást képviselő objektumot adja vissza.

Jegyzetek

A parancsmag futtatásához indítsa el a 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-CimInstance parancsmagot a szolgáltatást képviselő Win32_Service objektum lekéréséhez, majd a Törlés metódussal törölje a szolgáltatást. A visszaadott Get-Service objektum nem rendelkezik törlési módszerrel.