Inicia, detiene y suspende un servicio y cambia sus propiedades.
Sintaxis
Set-Service [-Name] <string> [-Descripción <string>] [-DisplayName <string>] [-PassThru] [-StartupType {<Automatic> | <Manual> | <Disabled>}] [-Status <string>] [-ComputerName <string[]>] [-Confirm] [-WhatIf] [<CommonParameters>]
Set-Service [-Descripción <string>] [-DisplayName <string>] [-InputObject <ServiceController>] [-PassThru] [-StartupType {<Automatic> | <Manual> | <Disabled>}] [-Status <string>] [-ComputerName <string[]>] [-Confirm] [-WhatIf] [<CommonParameters>]
Descripción
El cmdlet Set-Service cambia las propiedades de un servicio local o remoto, incluidos el estado, la descripción, el nombre para mostrar y el modo de inicio. Puede utilizar este cmdlet para iniciar, detener o suspender (pausar) un servicio. Para identificar el servicio, escriba su nombre o envíe un objeto de servicio, o bien, canalice un nombre de servicio o un objeto de servicio a Set-Service.
Parámetros
-ComputerName <string[]>
Especifica uno o varios equipos. El valor predeterminado es el equipo local.
Escriba el nombre NetBIOS, la dirección IP o el nombre de dominio completo de un equipo remoto. Para especificar el equipo local, escriba el nombre del equipo, un punto (.), o bien, "localhost".
Este parámetro no se basa en la comunicación remota de Windows PowerShell. Puede usar el parámetro ComputerName de Set-Service incluso si el equipo no está configurado para la ejecución de comandos remotos.
|
¿Requerido? |
false |
|
¿Posición? |
named |
|
Valor predeterminado |
local computer |
|
¿Aceptar canalización? |
true (ByPropertyName) |
|
¿Aceptar caracteres comodín? |
false |
-Descripción <string>
Especifica una nueva descripción para el servicio.
La descripción del servicio se muestra en Administración de equipos, en Servicios. La descripción no es una propiedad del objeto ServiceController que Get-Service obtiene. Para ver la descripción del servicio, utilice Get-WmiObject para obtener un objeto Win32_Service que representa el servicio.
|
¿Requerido? |
false |
|
¿Posición? |
named |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
false |
|
¿Aceptar caracteres comodín? |
false |
-DisplayName <string>
Especifica un nuevo nombre para mostrar para el servicio.
|
¿Requerido? |
false |
|
¿Posición? |
named |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
false |
|
¿Aceptar caracteres comodín? |
false |
-InputObject <ServiceController>
Especifica un objeto ServiceController que representa el servicio que se va a cambiar. Escriba una variable que contenga el objeto o escriba un comando o una expresión que lo obtenga, como un comando Get-Service. También puede canalizar un objeto de servicio a Set-Service.
|
¿Requerido? |
false |
|
¿Posición? |
named |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
true (ByValue) |
|
¿Aceptar caracteres comodín? |
false |
-Name <string>
Especifica el nombre del servicio que se va a cambiar. No se permite el uso de caracteres comodín. También puede canalizar un nombre de servicio a Set-Service.
|
¿Requerido? |
true |
|
¿Posición? |
1 |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
true (ByValue, ByPropertyName) |
|
¿Aceptar caracteres comodín? |
false |
-PassThru
Devuelve objetos que representan los servicios que se cambiaron. De forma predeterminada, este cmdlet no genera resultados.
|
¿Requerido? |
false |
|
¿Posición? |
named |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
false |
|
¿Aceptar caracteres comodín? |
false |
-StartupType <ServiceStartMode>
Cambia el modo de inicio del servicio. Los valores válidos de StartupType son:
-- Automatic: se inicia cuando se inicia el sistema.
-- Manual: se inicia únicamente cuando lo inicia un usuario o un programa.
-- Disabled: no se puede iniciar.
|
¿Requerido? |
false |
|
¿Posición? |
named |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
false |
|
¿Aceptar caracteres comodín? |
false |
-Status <string>
Inicia, detiene o suspende (pausa) los servicios. Los valores válidos son:
-- Running: inicia el servicio.
-- Stopped: detiene el servicio.
-- Paused: suspende el servicio.
|
¿Requerido? |
false |
|
¿Posición? |
named |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
false |
|
¿Aceptar caracteres comodín? |
false |
-Confirm
Solicita confirmación antes de ejecutar el comando.
|
¿Requerido? |
false |
|
¿Posición? |
named |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
false |
|
¿Aceptar caracteres comodín? |
false |
-WhatIf
Describe lo que ocurriría si ejecutara el comando sin ejecutarlo realmente.
|
¿Requerido? |
false |
|
¿Posición? |
named |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
false |
|
¿Aceptar caracteres comodín? |
false |
<CommonParameters>
Este cmdlet admite los parámetros comunes: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer y -OutVariable. Para obtener más información, vea about_Commonparameters.
Entradas y salidas
El tipo de entrada es el tipo de los objetos que se pueden canalizar al cmdlet. El tipo devuelto es el tipo de los objetos que el cmdlet devuelve.
|
Entradas |
System.ServiceProcess.ServiceController, System.String Puede canalizar a Set-Service un objeto de servicio o una cadena que contiene un nombre de servicio. |
|
Salidas |
Ninguno Este cmdlet no devuelve objetos. |
Notas
Para utilizar Set-Service en Windows Vista y versiones posteriores de Windows, inicie Windows PowerShell con la opción "Ejecutar como administrador".
Set-Service solo puede controlar los servicios si el usuario actual tiene permiso para ello. Si un comando no funciona correctamente, es posible que no tenga los permisos necesarios.
Para obtener los nombres de servicio y los nombres para mostrar de los servicios del sistema, escriba "Get-Service". Los nombres de servicio aparecen en la columna Name y los nombres para mostrar aparecen en la columna DisplayName.
Ejemplo 1
C:\PS>set-service -name lanmanworkstation -DisplayName "LanMan Workstation" Descripción ----------- Este comando cambia el nombre para mostrar del servicio lanmanworkstation a "LanMan Workstation". (El nombre predeterminado es "Workstation".)
Ejemplo 2
C:\PS>get-wmiobject win32_service -filter "name = 'SysmonLog'" ExitCode : 0 Name : SysmonLog ProcessId : 0 StartMode : Manual State : Stopped Status : OK C:\PS> set-service sysmonlog -startuptype automatic C:\PS> get-wmiobject win32_service -filter "name = 'SysmonLog'" ExitCode : 0 Name : SysmonLog ProcessId : 0 StartMode : Auto State : Stopped Status : OK C:\PS> get-wmiobject win32_service | format-table Name, StartMode -auto Name StartMode ---- --------- AdtAgent Auto Alerter Disabled ALG Manual AppMgmt Manual ... Descripción ----------- Estos comandos obtienen el tipo de inicio del servicio Registros y alertas de rendimiento (SysmonLog), establecen el modo de inicio en automático y muestran el resultado del cambio. Estos comandos utilizan el cmdlet Get-WmiObject para obtener el objeto Win32_Service del servicio, porque el objeto ServiceController que Get-Service devuelve no incluye el modo de inicio. El primer comando usa el Get-WmiObject para obtener el objeto de Instrumental de administración de Windows (WMI) que representa al servicio SysmonLog. El resultado predeterminado de este comando muestra el modo de inicio del servicio. El segundo comando usa Set-Service para cambiar el modo de inicio a automático. A continuación, se repite el primer comando para mostrar el cambio. El último comando muestra el modo de inicio de todos los servicios en el equipo.
Ejemplo 3
C:\PS>set-service -name Schedule -computername S1 -description "Configures and schedules tasks."
C:\PS> get-wmiobject win32_service -computername s1 | where-object {$_.Name -eq "Schedule"} | format-list Name, Description
Descripción
-----------
Estos comandos cambian la descripción del servicio Programador de tareas en el equipo remoto S1 y, a continuación, muestran el resultado.
Estos comandos utilizan el cmdlet Get-WmiObject para obtener el objeto Win32_Service del servicio, porque el objeto ServiceController que Get-Service devuelve no incluye la descripción del servicio.
El primer comando usa un comando Set-Service para cambiar la descripción. Identifica el servicio mediante el nombre de servicio del servicio, "Schedule".
El segundo comando usa el cmdlet Get-WmiObject para obtener una instancia de la clase Win32_Service de WMI que representa al servicio Programador de tareas. El primer elemento del comando obtiene todas las instancias de la clase Win32_service.
El operador de canalización (|) pasa el resultado al cmdlet Where-Object, que selecciona las instancias que contengan el valor "Schedule" en la propiedad Name.
Otro operador de canalización envía el resultado al cmdlet Format-List, que aplica al resultado un formato de lista que solo incluye las propiedades Name y Description.
Ejemplo 4
C:\PS>set-service winrm -status Running -passthru -computername Server02
Descripción
-----------
Este comando inicia el servicio WinRM en el equipo Server02. El comando utiliza el parámetro Status para especificar el estado deseado ("running") y el parámetro PassThru para indicar a Set-Service que devuelva un objeto que represente el servicio WinRM.
Ejemplo 5
C:\PS>get-service schedule -computername S1, S2 | set-service -status paused Descripción ----------- Este comando suspende el servicio Schedule en los equipos remotos S1 y S2. Usa el cmdlet Get-Service para obtener el servicio. Un operador de canalización (|) envía el servicio al cmdlet Set-Service, que cambia su estado a "Paused" (en pausa).
Ejemplo 6
C:\PS>$s = get-service schedule C:\PS> set-service -inputobject $s -status stopped Descripción ----------- Estos comandos detienen el servicio Schedule en el equipo local. El primer comando utiliza el cmdlet Get-Service para obtener el servicio Schedule. El comando guarda el servicio en la variable $s. El segundo comando usa el cmdlet Set-Service para cambiar el estado del servicio Schedule a "Stopped" (detenido). Utiliza el parámetro InputObject para enviar el servicio almacenado en la variable $s y usa el parámetro Status para especificar el estado deseado.
Vea también