Restart-Service
Detiene e inicia uno o varios servicios.
Syntax
Restart-Service
[-Force]
[-InputObject] <ServiceController[]>
[-PassThru]
[-Include <String[]>]
[-Exclude <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Restart-Service
[-Force]
[-Name] <String[]>
[-PassThru]
[-Include <String[]>]
[-Exclude <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Restart-Service
[-Force]
[-PassThru]
-DisplayName <String[]>
[-Include <String[]>]
[-Exclude <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
El cmdlet Restart-Service envía un mensaje de detención y, a continuación, un mensaje de inicio al controlador de servicio de Windows para un servicio especificado. Si un servicio ya estaba detenido, se inicia sin notificar de ningún error. Puede especificar los servicios por sus nombres de servicio o nombres para mostrar, o bien puede usar el parámetro InputObject para pasar un objeto que represente cada servicio que quiera reiniciar.
Ejemplos
Ejemplo 1: Reinicio de un servicio en el equipo local
PS C:\> Restart-Service -Name winmgmt
Este comando reinicia el servicio Instrumental de administración de Windows (WinMgmt) en el equipo local.
Ejemplo 2: Exclusión de un servicio
PS C:\> Restart-Service -DisplayName "net*" -Exclude "net logon"
Este comando reinicia los servicios que tienen un nombre para mostrar que comienza con Net, excepto para el servicio Net Logon.
Ejemplo 3: Iniciar todos los servicios de red detenidos
PS C:\> Get-Service -Name "net*" | Where-Object {$_.Status -eq "Stopped"} | Restart-Service
Este comando reinicia todos los servicios de red detenidos en el equipo.
Este comando usa el cmdlet Get-Service para obtener objetos que representan los servicios cuyo nombre de servicio comienza por net. El operador de canalización (|) envía el objeto de servicios al cmdlet Where-Object, que selecciona solo los servicios que tienen un estado detenido. Otro operador de canalización envía los servicios seleccionados a Restart-Service.
En la práctica, usaría el parámetro WhatIf para determinar el efecto del comando antes de ejecutarlo.
Parámetros
-Confirm
Le solicita su confirmación antes de ejecutar el cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisplayName
Especifica los nombres para mostrar de los servicios que se reiniciarán. Se permite el uso de caracteres comodín.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-Exclude
Especifica los servicios que este cmdlet omite. El valor de este parámetro califica el parámetro Name . Escriba un elemento de nombre o patrón, como s*. Se permite el uso de caracteres comodín.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-Force
Obliga al comando a ejecutarse sin solicitar la confirmación del usuario.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Include
Especifica los servicios que este cmdlet reinicia. El valor de este parámetro califica el parámetro Name . Escriba un elemento de nombre o patrón, como s*. Se permite el uso de caracteres comodín.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-InputObject
Especifica los objetos ServiceController que representan los servicios que se van a reiniciar. Especifique una variable que contenga los objetos o escriba un comando o una expresión que obtenga los objetos.
Type: | ServiceController[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
Especifica los nombres de servicio de los servicios que se van a reiniciar.
Type: | String[] |
Aliases: | ServiceName |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | True |
-PassThru
Devuelve un objeto que representa el servicio. De forma predeterminada, este cmdlet no genera ningún resultado.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entradas
System.ServiceProcess.ServiceController, System.String
Puede canalizar un objeto de servicio o una cadena que contenga un nombre de servicio a este cmdlet.
Salidas
None, System.ServiceProcess.ServiceController
Este cmdlet genera un objeto System.ServiceProcess.ServiceController que representa el servicio reiniciado, si especifica el parámetro PassThru . De lo contrario, este cmdlet no genera resultados.
Notas
- Restart-Service solo puede controlar los servicios cuando el usuario actual tiene permiso para hacerlo. Si un comando no funciona correctamente, puede que se deba a que no tiene los permisos necesarios.
- Para buscar los nombres de servicio y los nombres para mostrar de los servicios en el sistema, escriba Get-Service". Los nombres de servicio aparecen en la columna Nombre y los nombres para mostrar aparecen en la columna DisplayName .