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>]
   [-SecurityDescriptorSddl <String>]
   [-StartupType <ServiceStartupType>]
   [-Credential <PSCredential>]
   [-DependsOn <String[]>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

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

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: A szolgáltatás SecurityDescriptor beállítása létrehozáskor.

Ez a példa hozzáadja a létrehozott szolgáltatás SecurityDescriptor elemét.

$SDDL = "D:(A;;CCLCSWRPWPDTLOCRRC;;;SY)(A;;CCDCLCSWRPWPDTLOCRSDRCWDWO;;;BA)(A;;CCLCSWLOCRRC;;;SU)"
$params = @{
  BinaryPathName = 'C:\WINDOWS\System32\svchost.exe -k netsvcs'
  DependsOn = "NetLogon"
  DisplayName = "Test Service"
  StartupType = "Manual"
  Description = "This is a test service."
  SecurityDescriptorSddl = $SDDL
}
New-Service @params

A SecurityDescriptor a változóban $SDDLToSet van tárolva. A SecurityDescriptorSddl paraméter az új szolgáltatás SecurityDescriptor elemének beállítására szolgál$SDDL.

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
Aliases:Path
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

-SecurityDescriptorSddl

A szolgáltatás SecurityDescriptor paraméterét adja meg Sddl formátumban.

Type:String
Aliases:sd
Position:Named
Default value:None
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.
  • AutomaticDelayedStart – Röviddel a rendszer indítása után indul el.
  • Letiltva – A szolgáltatás le van tiltva, és egy felhasználó vagy alkalmazás nem indíthatja el.
  • InvalidValue – Ez az érték nem támogatott. Ha ezt az értéket használja, hiba történik.
  • Manuális – A szolgáltatást csak manuálisan, egy felhasználó, a Service Control Manager vagy egy alkalmazás indítja el.

Az alapértelmezett érték az Automatikus.

Type:ServiceStartupType
Accepted values:Automatic, Manual, Disabled, AutomaticDelayedStart, InvalidValue
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

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

A parancsmag futtatásához indítsa el a PowerShellt a Futtatás rendszergazdaként lehetőséggel.