Servicio
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
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de