Risorsa Service DSC
Si applica a: Windows PowerShell 4.0, Windows PowerShell 5.x
La risorsa Service in Windows PowerShell DSC (Desired State Configuration) fornisce un meccanismo per gestire i servizi nel nodo di destinazione.
Nota
Questa documentazione di questa risorsa DSC illustra la versione inclusa in PowerShell prima della versione 7.2. Il modulo PSDscResources contiene risorse DSC nuove e aggiornate supportate ufficialmente da Microsoft. Il modulo PSDscResources è disponibile da PowerShell Gallery.
Per altre informazioni e documentazione aggiornata, vedere la documentazione di riferimento psDscResources.
Sintassi
Service [string] #ResourceName
{
Name = [string]
[ BuiltInAccount = [string] { LocalService | LocalSystem | NetworkService } ]
[ Credential = [PSCredential] ]
[ StartupType = [string] { Automatic | Disabled | Manual } ]
[ State = [string] { Running | Stopped } ]
[ Dependencies = [string[]] ]
[ Description = [string] ]
[ DisplayName = [string] ]
[ Path = [string] ]
[ DependsOn = [string[]] ]
[ Ensure = [string] { Absent | Present } ]
[ PsDscRunAsCredential = [PSCredential] ]
}
Proprietà
Proprietà | Descrizione |
---|---|
Nome | Indica il nome del servizio. A volte questo nome è diverso da quello visualizzato. È possibile ottenere un elenco dei servizi e del rispettivo stato corrente usando il cmdlet Get-Service . |
BuiltInAccount | Indica l'account di accesso da usare per il servizio. I valori consentiti per questa proprietà sono: LocalService, LocalSystem e NetworkService. |
Credenziale | Indica le credenziali per l'account in cui verrà eseguito il servizio. Questa proprietà e la proprietà BuiltinAccount non possono essere usate insieme. |
StartupType | Indica il tipo di avvio per il servizio. I valori consentiti per questa proprietà sono: Automatic, Disabled e Manual. |
State | Indica lo stato che si vuole specificare per il servizio. I valori possibili sono: Running o Stopped. |
Dependencies | Matrice dei nomi delle dipendenze che il servizio deve avere. |
Descrizione | Specifica la descrizione del servizio di destinazione. |
DisplayName | Indica il nome visualizzato del servizio di destinazione. |
Percorso | Indica il percorso del file binario per un nuovo servizio. |
Proprietà comuni
Proprietà | Descrizione |
---|---|
DependsOn | Indica che prima di configurare la risorsa è necessario eseguire la configurazione di un'altra risorsa. Ad esempio, se il valore di ID del blocco script di configurazione della risorsa che si vuole eseguire per primo è ResourceName e il tipo è ResourceType, la sintassi per usare questa proprietà è DependsOn = "[ResourceType]ResourceName" . |
Ensure | Indica se il servizio di destinazione è presente nel sistema. Impostare questa proprietà su Absent per specificare che il servizio di destinazione non esiste. Impostando il valore su Present ci si assicura che il servizio di destinazione esista. Il valore predefinito è Present. |
PsDscRunAsCredential | Imposta le credenziali per l'esecuzione dell'intera risorsa. |
Nota
La proprietà comune PsDscRunAsCredential è stata aggiunta in WMF 5.0 per consentire l'esecuzione di qualsiasi risorsa DSC nel contesto di altre credenziali. Per altre informazioni, vedere Usare credenziali con risorse DSC.
Esempio
configuration ServiceTest
{
Import-DscResource -ModuleName PSDesiredStateConfiguration
Node localhost
{
Service ServiceExample
{
Name = "TermService"
StartupType = "Manual"
State = "Running"
}
}
}
Commenti e suggerimenti
https://aka.ms/ContentUserFeedback.
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedereInvia e visualizza il feedback per