Servizio
Riepilogo
Gestire un servizio Windows.
Sintassi
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]]
}
Descrizione
La Service risorsa consente di aggiungere, aggiornare e rimuovere servizi.
Requisiti
No.
Proprietà della chiave
Nome
Specificare il nome del servizio come stringa.
Nota
In alcuni casi questo valore è diverso dal nome visualizzato. È possibile ottenere un elenco dei servizi e del rispettivo stato corrente usando il cmdlet Get-Service.
Type: System.String
Proprietà facoltative
BuiltInAccount
Specificare il nome dell'account del computer per eseguire il servizio come . L'account deve avere accesso all'eseguibile specificato da Path per avviare il servizio.
Non specificare questa proprietà con la proprietà Credential .
Type: System.String
Accepted Values:
- LocalService
- LocalSystem
- NetworkService
Default Value: Null
Credenziale
Specificare le credenziali per un account per l'esecuzione del servizio come . L'account deve avere accesso all'eseguibile specificato da Path per avviare il servizio. La risorsa concede automaticamente all'account il diritto "Accedi come servizio".
Non specificare questa proprietà con la proprietà BuiltInAccount .
Type: System.Management.Automation.PSCredential
Default Value: None
Dipendenze
Specificare i nomi dei servizi necessari per l'esecuzione del servizio come matrice di stringhe.
Type: System.String[]
Default Value: None
Descrizione
Specificare la descrizione del servizio come stringa. La descrizione del servizio viene visualizzata in Gestione computer, Servizi.
Type: System.String
Default Value: None
DesktopInteract
Specificare se il servizio può creare o comunicare con una finestra sul desktop. Questa proprietà deve essere $false se BuiltInAccount non è specificato come LocalSystem.
Il valore predefinito è $false.
Type: System.Boolean
Default Value: false
DisplayName
Specificare il nome visualizzato descrittivo del servizio come stringa.
Type: System.String
Default Value: None
Ensure
Specificare se il servizio deve esistere. Per aggiungere o aggiornare un servizio, impostare questa proprietà su Present. Per rimuovere un servizio, impostare questa proprietà su Absent.
Il valore predefinito è Present.
Type: System.String
Accepted Values:
- Absent
- Present
Default Value: Present
Percorso
Specificare il percorso del file eseguibile del servizio come stringa. Questa proprietà è necessaria se il servizio non esiste.
Type: System.String
Default Value: None
StartupTimeout
Specificare il tempo di attesa per l'avvio del servizio in millisecondi.
Il valore predefinito è 30000.
Type: System.UInt32
Default Value: 30000
StartupType
Specificare il comportamento del servizio all'avvio del sistema. Il valore deve essere uno dei seguenti:
Automatic- Il servizio viene avviato dal sistema operativo all'avvio del sistema. Se un servizio avviato automaticamente dipende da un servizio avviato manualmente, il servizio avviato manualmente viene avviato automaticamente anche all'avvio del sistema.Disabled- Il servizio è disabilitato e non può essere avviato da un utente o da un'applicazione.Manual- Il servizio viene avviato solo manualmente, da un utente, tramite Gestione controllo servizi o da un'applicazione.
Se il servizio non esiste, il valore predefinito è Automatic.
Type: System.String
Behavior: Write
Accepted Values:
- Automatic
- Disabled
- Manual
Default Value: None
State
Specificare se il servizio deve essere eseguito. Il valore deve essere uno dei seguenti:
Running- La risorsa avvia il servizio se non è già stata avviata.Stopped- La risorsa arresta il servizio se è in esecuzione.Ignore- La risorsa non avvia o arresta il servizio.
Il valore predefinito è Running.
Type: System.String
Accepted Values:
- Running
- Stopped
- Ignore
Default Value: Running
TerminateTimeout
Specificare il tempo di attesa per l'arresto del servizio in millisecondi. Il valore predefinito è 30000.
Type: System.UInt32
Default Value: 30000
