Recurso de DSC Service

Se aplica a: Windows PowerShell 4.0, Windows PowerShell 5.x

El recurso Service de la configuración de estado deseado (DSC) de Windows PowerShell ofrece un mecanismo para administrar servicios en el nodo de destino.

Nota

Esta documentación de este recurso de DSC cubre la versión que se incluye con PowerShell antes de la versión 7.2. El módulo PSDscResources contiene recursos de DSC nuevos y actualizados compatibles oficialmente con Microsoft. El módulo PSDscResources está disponible en la Galería de PowerShell.

Para obtener más información y documentación actualizada, consulte la documentación de referencia de PSDscResources.

Sintaxis

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] ]
}

Propiedades

Propiedad	Descripción
Nombre	Indica el nombre del servicio. Tenga en cuenta que a veces es distinto del nombre para mostrar. Con el cmdlet Get-Service puede obtener una lista de los servicios y sus estados actuales.
BuiltInAccount	Indica la cuenta de inicio de sesión que se utilizará para el servicio. Los valores permitidos para esta propiedad son: LocalService, LocalSystem y NetworkService.
Credential:	Indica las credenciales de la cuenta en la que se ejecutará el servicio. Esta propiedad no se puede utilizar junto con la propiedad BuiltinAccount.
StartupType	Indica el tipo de inicio del servicio. Los valores permitidos para esta propiedad son: Automatic, Disabled y Manual.
State	Indica el estado que quiere garantizar para el servicio. Los valores son: Running o Stopped.
Dependencias	Matriz con los nombres de las dependencias que debe tener el servicio.
Descripción	Indica la descripción del servicio de destino.
DisplayName	Indica el nombre para mostrar del servicio de destino.
Path	Indica la ruta de acceso al archivo binario para un nuevo servicio.

Propiedades comunes

Propiedad	Descripción
DependsOn	Indica que la configuración de otro recurso debe ejecutarse antes de que se configure este recurso. Por ejemplo, si el elemento ID del bloque del script de configuración del recurso que quiere ejecutar primero es ResourceName y su tipo es ResourceType, la sintaxis para usar esta propiedad es DependsOn = "[ResourceType]ResourceName".
Ensure	Indica si el servicio de destino existe en el sistema. Establezca esta propiedad en Absent para asegurarse de que el servicio de destino no exista. Si la establece en Present, se asegura de que el servicio de destino existe. El valor predeterminado es Present.
PsDscRunAsCredential	Establece la credencial con la que se ejecutará todo el recurso.

Nota

Se ha agregado la propiedad común PsDscRunAsCredential en WMF 5.0 para permitir la ejecución de cualquier recurso de DSC en el contexto de otras credenciales. Para obtener más información, vea Uso de las credenciales con recursos de DSC.

Ejemplo

configuration ServiceTest
{
    Import-DscResource -ModuleName PSDesiredStateConfiguration

    Node localhost
    {

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