Share via

Servicio

  • Artículo

Sinopsis

Administrar un servicio de Windows.

Sintaxis

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

Descripción

El Service recurso permite agregar, actualizar y quitar servicios.

Requisitos

Ninguno.

Propiedades de la clave

Nombre

Especifique el nombre del servicio como una cadena.

Nota

A veces, este valor es diferente del nombre para mostrar. Con el cmdlet Get-Service puede obtener una lista de los servicios y sus estados actuales.

Type: System.String

Propiedades opcionales

BuiltInAccount

Especifique el nombre de la cuenta de máquina para ejecutar el servicio como. La cuenta debe tener acceso al archivo ejecutable especificado por Path para iniciar el servicio.

No especifique esta propiedad con la propiedad Credential .

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

Credential:

Especifique la credencial de una cuenta para ejecutar el servicio como. La cuenta debe tener acceso al archivo ejecutable especificado por Path para iniciar el servicio. El recurso concede automáticamente a esta cuenta el derecho "Iniciar sesión como servicio".

No especifique esta propiedad con la propiedad BuiltInAccount .

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

Dependencias

Especifique los nombres de los servicios que requiere este servicio para ejecutarse como una matriz de cadenas.

Type: System.String[]
Default Value: None

Descripción

Especifique la descripción del servicio como una cadena. La descripción del servicio aparece en Administración de equipos, Servicios.

Type: System.String
Default Value: None

DesktopInteract

Especifique si el servicio puede crear o comunicarse con una ventana en el escritorio. Esta propiedad debe ser $false si BuiltInAccount no se especifica como LocalSystem.

El valor predeterminado es $false.

Type: System.Boolean
Default Value: false

DisplayName

Especifique el nombre para mostrar descriptivo del servicio como una cadena.

Type: System.String
Default Value: None

Ensure

Especifique si el servicio debe existir. Para agregar o actualizar un servicio, establezca esta propiedad en Present. Para quitar un servicio, establezca esta propiedad en Absent.

El valor predeterminado es Present.

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

Ruta de acceso

Especifique la ruta de acceso al archivo ejecutable del servicio como una cadena. Esta propiedad es necesaria si el servicio no existe.

Type: System.String
Default Value: None

StartupTimeout

Especifique el tiempo de espera para que el servicio se inicie en milisegundos.

El valor predeterminado es 30000.

Type: System.UInt32
Default Value: 30000

StartupType

Especifique cómo debe comportarse el servicio en el inicio del sistema. Debe tener uno de los siguientes valores:

  • Automatic - El sistema operativo inicia el servicio en el inicio del sistema. Si un servicio iniciado automáticamente depende de un servicio iniciado manualmente, el servicio iniciado manualmente también se inicia automáticamente en el inicio del sistema.
  • Disabled - El servicio está deshabilitado y no puede iniciarlo un usuario o una aplicación.
  • Manual - El servicio solo se inicia manualmente, por un usuario, mediante el Administrador de control de servicios o por una aplicación.

Si el servicio no existe, el valor predeterminado es Automatic.

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

State

Especifique si se debe ejecutar el servicio. Debe tener uno de los siguientes valores:

  • Running - El recurso inicia el servicio si aún no se ha iniciado.
  • Stopped : el recurso detiene el servicio si se está ejecutando.
  • Ignore - El recurso no se inicia ni detiene el servicio.

El valor predeterminado es Running.

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

TerminateTimeout

Especifique el tiempo de espera para que el servicio se detenga en milisegundos. El valor predeterminado es 30000.

Type: System.UInt32
Default Value: 30000

Ejemplos