Share via

Tjänst

  • Artikel

Synopsis

Hantera en Windows-tjänst.

Syntax

Service [String] #ResourceName
{
    Name = [string]
    [BuiltInAccount = [string]{ LocalService | LocalSystem | NetworkService }]
    [Credential = [PSCredential]]
    [Dependencies = [string[]]]
    [DependsOn = [string[]]]
    [Description = [string]]
    [DesktopInteract = [bool]]
    [DisplayName = [string]]
    [Ensure = [string]{ Absent | Present }]
    [Path = [string]]
    [PsDscRunAsCredential = [PSCredential]]
    [StartupTimeout = [UInt32]]
    [StartupType = [string]{ Automatic | Disabled | Manual }]
    [State = [string]{ Ignore | Running | Stopped }]
    [TerminateTimeout = [UInt32]]
}

Description

Med resursen Service kan du lägga till, uppdatera och ta bort tjänster.

Krav

Inga.

Nyckelegenskaper

Name

Ange tjänstnamnet som en sträng.

Anteckning

Ibland skiljer sig det här värdet från visningsnamnet. Du kan hämta en lista över tjänsterna och deras aktuella tillstånd med cmdleten Get-Service .

Type: System.String

Valfria egenskaper

BuiltInAccount

Ange namnet på det datorkonto som ska köra tjänsten som. Kontot måste ha åtkomst till den körbara fil som anges av Sökväg för att kunna starta tjänsten.

Ange inte den här egenskapen med egenskapen Autentiseringsuppgifter .

Type: System.String
Accepted Values:
  - LocalService
  - LocalSystem
  - NetworkService
Default Value: Null

Autentiseringsuppgift

Ange autentiseringsuppgifterna för ett konto som ska köra tjänsten som. Kontot måste ha åtkomst till den körbara fil som anges av Sökväg för att starta tjänsten. Resursen beviljar automatiskt det här kontot rättigheten "Logga in som en tjänst".

Ange inte den här egenskapen med egenskapen BuiltInAccount .

Type: System.Management.Automation.PSCredential
Default Value: None

Beroenden

Ange namnen på de tjänster som den här tjänsten kräver för att köras som en matris med strängar.

Type: System.String[]
Default Value: None

Description

Ange beskrivningen av tjänsten som en sträng. Tjänstbeskrivningen visas i Datorhantering, Tjänster.

Type: System.String
Default Value: None

DesktopInteract

Ange om tjänsten kan skapa eller kommunicera med ett fönster på skrivbordet. Den här egenskapen måste vara $false om BuiltInAccount inte har angetts som LocalSystem.

Standardvärdet är $false.

Type: System.Boolean
Default Value: false

DisplayName

Ange det människovänliga visningsnamnet för tjänsten som en sträng.

Type: System.String
Default Value: None

Säkerställa

Ange om tjänsten ska finnas. Om du vill lägga till eller uppdatera en tjänst anger du den här egenskapen till Present. Om du vill ta bort en tjänst anger du den här egenskapen till Absent.

Standardvärdet är Present.

Type: System.String
Accepted Values:
  - Absent
  - Present
Default Value: Present

Sökväg

Ange sökvägen till tjänstens körbara fil som en sträng. Den här egenskapen krävs om tjänsten inte finns.

Type: System.String
Default Value: None

StartupTimeout

Ange hur länge tjänsten ska starta i millisekunder.

Standardvärdet är 30000.

Type: System.UInt32
Default Value: 30000

StartupType

Ange hur tjänsten ska fungera vid systemstart. Värdet måste vara något av följande:

  • Automatic - Tjänsten startas 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.
  • Disabled - Tjänsten är inaktiverad och kan inte startas av en användare eller ett program.
  • Manual – Tjänsten startas endast manuellt, av en användare, med hjälp av Service Control Manager eller av ett program.

Om tjänsten inte finns är Automaticstandardvärdet .

Type: System.String
Behavior: Write
Accepted Values:
  - Automatic
  - Disabled
  - Manual
Default Value: None

Tillstånd

Ange om tjänsten ska köras. Värdet måste vara något av följande:

  • Running – Resursen startar tjänsten om den inte redan har startats.
  • Stopped – Resursen stoppar tjänsten om den körs.
  • Ignore – Resursen startar eller stoppar inte tjänsten.

Standardvärdet är Running.

Type: System.String
Accepted Values:
  - Running
  - Stopped
  - Ignore
Default Value: Running

TerminateTimeout

Ange hur länge tjänsten ska stoppas i millisekunder. Standardvärdet är 30000.

Type: System.UInt32
Default Value: 30000

Exempel