ServiceSet

Artículo
05/05/2023

Sinopsis

Administrar varios servicios con la configuración común.

Sintaxis

ServiceSet [String] #ResourceName
{
    [DependsOn = [String[]]]
    [PsDscRunAsCredential = [PSCredential]]
    Name = [String[]]
    [Ensure = [String]]
    [StartupType = [String]]
    [BuiltInAccount = [String]]
    [State = [String]]
    [Credential = [PSCredential]]
}

Descripción

ServiceSet es un recurso compuesto que facilita la administración de varios servicios a la vez con configuraciones compartidas pero limitadas. Este recurso solo puede actualizar o quitar los servicios existentes. No puede crear servicios. Para obtener más control sobre la configuración de los servicios, consulte el recurso Servicio.

Importante

Los recursos compuestos no funcionan con Invoke-DscResource. Este recurso solo se puede usar dentro de una Configuration definición.

Requisitos

Ninguno.

Propiedades

Propiedades de la clave

Nombre

Especifique los nombres de los servicios como una matriz de cadenas.

Esto puede ser diferente del nombre para mostrar del servicio. Para recuperar una lista de todos los servicios con sus nombres y estados actuales, use el Get-Service cmdlet .

Type: System.String[]
Behavior: Key

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 de cada servicio 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 los servicios como. La cuenta debe tener acceso al archivo ejecutable de cada servicio para iniciar ese 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

Ensure

Especifique si los servicios deben 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

StartupType

Especifique cómo deben comportarse los servicios 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 los servicios deben ejecutarse. 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

Share via