Risorsa Service DSCDSC Service Resource

Si applica a: Windows PowerShell 4.0, Windows PowerShell 5.xApplies To: 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.The Service resource in Windows PowerShell Desired State Configuration (DSC) provides a mechanism to manage services on the target node.

Nota

La documentazione di questa risorsa DSC riguarda la versione inclusa in PowerShell.This documentation of this DSC resource covers the version that is included with PowerShell. Il modulo PSDscResources contiene elementi nuovi e aggiornati ufficialmente supportati da Microsoft.The PSDscResources module contains new and updated that are officially supported by Microsoft. Il modulo PSDscResources è disponibile da PowerShell Gallery.The PSDscResources module is available from the PowerShell Gallery.

Per altre informazioni e per la documentazione aggiornata, vedere il file LEGGIMI nel repository GitHub.For more information and updated documentation, see the README in the GitHub repository.

SintassiSyntax

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

ProprietàProperties

ProprietàProperty DescrizioneDescription
NomeName Indica il nome del servizio.Indicates the service name. A volte questo nome è diverso da quello visualizzato.Note that sometimes this is different from the display name. È possibile ottenere un elenco dei servizi e del rispettivo stato corrente usando il cmdlet Get-Service.You can get a list of the services and their current state with the Get-Service cmdlet.
BuiltInAccountBuiltInAccount Indica l'account di accesso da usare per il servizio.Indicates the sign-in account to use for the service. I valori consentiti per questa proprietà sono: LocalService , LocalSystem e NetworkService .The values that are allowed for this property are: LocalService , LocalSystem , and NetworkService .
CredenzialeCredential Indica le credenziali per l'account in cui verrà eseguito il servizio.Indicates credentials for the account that the service will run under. Questa proprietà e la proprietà BuiltinAccount non possono essere usate insieme.This property and the BuiltinAccount property cannot be used together.
StartupTypeStartupType Indica il tipo di avvio per il servizio.Indicates the startup type for the service. I valori consentiti per questa proprietà sono: Automatic , Disabled e Manual .The values that are allowed for this property are: Automatic , Disabled , and Manual .
StateState Indica lo stato che si vuole specificare per il servizio.Indicates the state you want to ensure for the service. I valori possibili sono: Running o Stopped .The values are: Running or Stopped .
DependenciesDependencies Matrice dei nomi delle dipendenze che il servizio deve avere.An array of the names of the dependencies the service should have.
DescrizioneDescription Specifica la descrizione del servizio di destinazione.Indicates the description of the target service.
DisplayNameDisplayName Indica il nome visualizzato del servizio di destinazione.Indicates the display name of the target service.
PercorsoPath Indica il percorso del file binario per un nuovo servizio.Indicates the path to the binary file for a new service.

Proprietà comuniCommon properties

ProprietàProperty DescrizioneDescription
DependsOnDependsOn Indica che prima di configurare la risorsa è necessario eseguire la configurazione di un'altra risorsa.Indicates that the configuration of another resource must run before this resource is configured. 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".For example, if the ID of the resource configuration script block that you want to run first is ResourceName and its type is ResourceType, the syntax for using this property is DependsOn = "[ResourceType]ResourceName".
EnsureEnsure Indica se il servizio di destinazione è presente nel sistema.Indicates whether the target service exists on the system. Impostare questa proprietà su Absent per specificare che il servizio di destinazione non esiste.Set this property to Absent to ensure that the target service does not exist. Impostando il valore su Present ci si assicura che il servizio di destinazione esista.Setting it to Present ensures that target service exists. Il valore predefinito è Present .The default value is Present .
PsDscRunAsCredentialPsDscRunAsCredential Imposta le credenziali per l'esecuzione dell'intera risorsa.Sets the credential for running the entire resource as.

Nota

La proprietà comune PsDscRunAsCredential è stata aggiunta in WMF 5.0 per consentire l'esecuzione di qualsiasi risorsa DSC nel contesto di altre credenziali.The PsDscRunAsCredential common property was added in WMF 5.0 to allow running any DSC resource in the context of other credentials. Per altre informazioni, vedere Usare credenziali con risorse DSC.For more information, see Use Credentials with DSC Resources.

EsempioExample

configuration ServiceTest
{
    Import-DscResource -ModuleName PSDesiredStateConfiguration
    Node localhost
    {

        Service ServiceExample
        {
            Name        = "TermService"
            StartupType = "Manual"
            State       = "Running"
        }
    }
}