Dela via

New-Service

  • Referens
Modul:
Microsoft.PowerShell.Management

Skapar en ny Windows-tjänst.

Syntax

New-Service
   [-Name] <String>
   [-BinaryPathName] <String>
   [-DisplayName <String>]
   [-Description <String>]
   [-StartupType <ServiceStartMode>]
   [-Credential <PSCredential>]
   [-DependsOn <String[]>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Cmdleten New-Service skapar en ny post för en Windows-tjänst i registret och i tjänstdatabasen. En ny tjänst kräver en körbar fil som körs under tjänsten.

Med parametrarna i den här cmdleten kan du ange visningsnamn, beskrivning, starttyp och beroenden för tjänsten.

Exempel

Exempel 1: Skapa en tjänst

PS C:\> New-Service -Name "TestService" -BinaryPathName "C:\WINDOWS\System32\svchost.exe -k netsvcs"

Det här kommandot skapar en tjänst med namnet TestService.

Exempel 2: Skapa en tjänst som innehåller beskrivning, starttyp och visningsnamn

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

Det här kommandot skapar en tjänst med namnet TestService. Den använder parametrarna för New-Service för att ange en beskrivning, starttyp och visningsnamn för den nya tjänsten.

Exempel 3: Visa den nya tjänsten

PS C:\> Get-WmiObject win32_service -Filter "name='testservice'"
ExitCode  : 0
Name      : testservice
ProcessId : 0
StartMode : Auto
State     : Stopped
Status    : OK

Det här kommandot använder Get-WmiObject- för att hämta Win32_Service-objektet för den nya tjänsten. Det här objektet innehåller startläget och tjänstbeskrivningen.

Exempel 4: Ta bort en tjänst

PS C:\> sc.exe delete TestService
- or -
PS C:\> (Get-WmiObject win32_service -Filter "name='TestService'").delete()

Det här exemplet visar två sätt att ta bort TestService-tjänsten. Det första kommandot använder borttagningsalternativet Sc.exe. Det andra kommandot använder metoden Ta bort för de Win32_Service objekt som Get-WmiObject- returnerar.

Parametrar

-BinaryPathName

Anger sökvägen till den körbara filen för tjänsten. Den här parametern krävs.

Typ:String
Position:1
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Typ:SwitchParameter
Alias:cf
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Credential

Anger det konto som används av tjänsten som -tjänstinloggningskontot.

Ange ett användarnamn, till exempel User01 eller Domain01\User01, eller ange ett PSCredential- objekt, till exempel ett som genereras av cmdleten Get-Credential. Om du skriver ett användarnamn uppmanas du att ange ett lösenord i den här cmdleten.

Typ:PSCredential
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-DependsOn

Anger namnen på andra tjänster som den nya tjänsten är beroende av. Om du vill ange flera tjänstnamn använder du ett kommatecken för att avgränsa namnen.

Typ:String[]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Description

Anger en beskrivning av tjänsten.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-DisplayName

Anger ett visningsnamn för tjänsten.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Name

Anger namnet på tjänsten. Den här parametern krävs.

Typ:String
Alias:ServiceName
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-StartupType

Anger starttypen för tjänsten. De godtagbara värdena för den här parametern är:

  • Handbok. Tjänsten startas endast manuellt, av en användare, med hjälp av Service Control Manager eller av ett program.
  • Automatisk. Tjänsten startas eller startades av operativsystemet vid systemstart. Om en automatiskt startad tjänst är beroende av en manuellt startad tjänst startas även den manuellt startade tjänsten automatiskt vid systemstart.
  • Handikappad. Tjänsten är inaktiverad och kan inte startas av en användare eller ett program.

Standardvärdet är Automatisk.

Typ:ServiceStartMode
Godkända värden:Automatic, Manual, Disabled
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-WhatIf

Visar vad som skulle hända om cmdleten körs. Cmdleten körs inte.

Typ:SwitchParameter
Alias:wi
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Indata

None

Du kan inte skicka indata till den här cmdleten.

Utdata

ServiceController

Den här cmdleten returnerar ett objekt som representerar den nya tjänsten.

Kommentarer

  • Om du vill köra den här cmdleten i Windows Vista och senare versioner av Windows-operativsystemet startar du Windows PowerShell med alternativet Kör som administratör.
  • Om du vill ta bort en tjänst använder du Sc.exeeller använder cmdleten Get-WmiObject för att hämta det Win32_Service objekt som representerar tjänsten och sedan använda metoden Ta bort för att ta bort tjänsten. Objektet som Get-Service returnerar har ingen borttagningsmetod.