Detiene y después inicia uno o más servicios.
Sintaxis
Restart-Service [-Name] <string[]> [-Exclude <string[]>] [-Force] [-Include <string[]>] [-PassThru] [-Confirm] [-WhatIf] [<CommonParameters>] Restart-Service -DisplayName <string[]> [-Exclude <string[]>] [-Force] [-Include <string[]>] [-PassThru] [-Confirm] [-WhatIf] [<CommonParameters>] Restart-Service [-InputObject <ServiceController[]>] [-Exclude <string[]>] [-Force] [-Include <string[]>] [-PassThru] [-Confirm] [-WhatIf] [<CommonParameters>]
Descripción
El cmdlet Restart-Service envía un mensaje de detención y, a continuación, un mensaje de inicio al controlador de servicios de Windows para un servicio especificado. Si un servicio ya estaba detenido, se inicia sin notificar un error. Puede especificar los servicios por su nombre de servicio o por su nombre para mostrar, o puede usar el parámetro InputObject para pasar un objeto que represente a cada servicio que desee reiniciar.
Parámetros
-DisplayName <string[]>
Especifica los nombres para mostrar de los servicios que se van a reiniciar. Se permite el uso de caracteres comodín.
|
¿Requerido? |
true |
|
¿Posición? |
named |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
false |
|
¿Aceptar caracteres comodín? |
false |
-Exclude <string[]>
Omite los servicios especificados. El valor de este parámetro califica el parámetro Name. Escriba un patrón o un elemento del nombre, como "s*". Se permite el uso de caracteres comodín.
|
¿Requerido? |
false |
|
¿Posición? |
named |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
false |
|
¿Aceptar caracteres comodín? |
false |
-Force
Pasa por alto las restricciones que impiden que el comando se ejecute correctamente, de tal modo que los cambios no pongan en peligro la seguridad. Por ejemplo, Force detendrá y reiniciará un servicio que tenga servicios dependientes.
|
¿Requerido? |
false |
|
¿Posición? |
named |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
false |
|
¿Aceptar caracteres comodín? |
false |
-Include <string[]>
Reinicia únicamente los servicios especificados. El valor de este parámetro califica el parámetro Name. Escriba un patrón o un elemento del nombre, como "s*". Se permite el uso de caracteres comodín.
|
¿Requerido? |
false |
|
¿Posición? |
named |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
false |
|
¿Aceptar caracteres comodín? |
false |
-InputObject <ServiceController[]>
Especifica objetos ServiceController que representan los servicios que se van a reiniciar. Especifique la variable que contiene los objetos, o bien, escriba un comando o una expresión que obtenga los objetos.
|
¿Requerido? |
false |
|
¿Posición? |
named |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
true (ByValue) |
|
¿Aceptar caracteres comodín? |
false |
-Name <string[]>
Especifica los nombres de los servicios que se van a reiniciar.
|
¿Requerido? |
true |
|
¿Posición? |
1 |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
true (ByValue, ByPropertyName) |
|
¿Aceptar caracteres comodín? |
false |
-PassThru
Devuelve un objeto que representa el servicio. De forma predeterminada, este cmdlet no genera resultados.
|
¿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 Restart-Service un objeto de servicio o una cadena que contiene un nombre de servicio. |
|
Salidas |
Ninguno o System.ServiceProcess.ServiceController Cuando se usa el parámetro PassThru, Restart-Service genera un objeto System.ServiceProcess.ServiceController que representa el servicio reiniciado. En caso contrario, este cmdlet no genera resultados. |
Notas
Restart-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>restart-service wmi Descripción ----------- Este comando reinicia el servicio Instrumental de administración de Windows (WMI) en el equipo local.
Ejemplo 2
C:\PS>restart-service -displayname net* -exclude "net logon" Descripción ----------- Este comando reinicia los servicios que tengan un nombre para mostrar que empiece por "Net", salvo el servicio "Net Logon".
Ejemplo 3
C:\PS>get-service net* | where-object {$_.Status -eq "Stopped"} | restart-service
Descripción
-----------
Este comando inicia todos los servicios de red del equipo que estén detenidos.
Usa el cmdlet Get-Service para obtener los objetos que representen los servicios cuyo nombre empiece por "net". (El nombre del parámetro Name opcional se omite). El operador de canalización (|) envía el objeto de servicios al cmdlet Where-Object, que solamente selecciona los servicios cuyo estado sea "stopped" (detenido). Otro operador de canalización envía los servicios seleccionados a Restart-Service. En la práctica, se usa el parámetro WhatIf para ver el efecto del comando antes de usarlo.
Vea también