Sdílet prostřednictvím

Služba

  • Článek

Synopse

Správa služby systému Windows

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

Prostředek Service umožňuje přidávat, aktualizovat a odebírat služby.

Požadavky

Žádné

Základní vlastnosti

Name

Zadejte název služby jako řetězec.

Poznámka

Někdy se tato hodnota liší od zobrazovaného názvu. Pomocí rutiny můžete získat seznam služeb a jejich aktuální stav Get-Service .

Type: System.String

Volitelné vlastnosti

BuiltInAccount

Zadejte název účtu počítače, který má službu spustit jako. Aby mohl spustit službu, musí mít účet přístup ke spustitelnému souboru určenému cestou .

Tuto vlastnost nezadávejte pomocí vlastnosti Credential .

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

Přihlašovací údaj

Zadejte přihlašovací údaje pro účet, který má službu spustit jako. Aby se služba spustila, musí mít účet přístup ke spustitelnému souboru určenému cestou . Prostředek automaticky udělí tomuto účtu právo Přihlásit se jako služba.

Tuto vlastnost nezadávejte pomocí vlastnosti BuiltInAccount .

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

Závislosti

Zadejte názvy služeb, které tato služba vyžaduje, aby byla spuštěna jako pole řetězců.

Type: System.String[]
Default Value: None

Description

Zadejte popis služby jako řetězec. Popis služby se zobrazí v části Správa počítače, Služby.

Type: System.String
Default Value: None

DesktopInteract

Určete, jestli může služba vytvořit nebo komunikovat s oknem na ploše. Tato vlastnost musí být $false , pokud BuiltInAccount není zadán jako LocalSystem.

Výchozí hodnota je $false.

Type: System.Boolean
Default Value: false

DisplayName

Zadejte zobrazovaný název služby pro člověka jako řetězec.

Type: System.String
Default Value: None

Zajištění

Určete, jestli má služba existovat. Chcete-li přidat nebo aktualizovat službu, nastavte tuto vlastnost na Present. Chcete-li odebrat službu, nastavte tuto vlastnost na Absent.

Výchozí hodnota je Present.

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

Cesta

Zadejte cestu ke spustitelnému souboru služby jako řetězec. Tato vlastnost se vyžaduje, pokud služba neexistuje.

Type: System.String
Default Value: None

StartupTimeout

Zadejte dobu čekání na spuštění služby v milisekundách.

Výchozí hodnota je 30000.

Type: System.UInt32
Default Value: 30000

StartupType

Určete, jak se má služba chovat při spuštění systému. Hodnota musí být jedna z následujících hodnot:

  • Automatic – Služba je spuštěna operačním systémem při spuštění systému. Pokud automaticky spuštěná služba závisí na ručně spuštěné službě, automaticky se spustí také při spuštění systému.
  • Disabled – Služba je zakázaná a nejde ji spustit uživatelem nebo aplikací.
  • Manual – Služba je spuštěna pouze ručně, uživatelem, pomocí Správce řízení služeb nebo aplikací.

Pokud služba neexistuje, výchozí hodnota je Automatic.

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

Stav

Určete, zda má být služba spuštěna. Hodnota musí být jedna z následujících hodnot:

  • Running – Prostředek spustí službu, pokud ještě není spuštěná.
  • Stopped – Prostředek zastaví službu, pokud je spuštěná.
  • Ignore – Prostředek službu nespustí ani nezastaví.

Výchozí hodnota je Running.

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

TerminateTimeout

Zadejte dobu čekání na zastavení služby v milisekundách. Výchozí hodnota je 30000.

Type: System.UInt32
Default Value: 30000

Příklady