Restart-Service

  • Referencia
Módulo:
Microsoft.PowerShell.Management

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

Este cmdlet solo está disponible en la plataforma Windows.

El Restart-Service cmdlet 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 Inicio de sesión de Net.

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 Get-Service cmdlet 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 Where-Object cmdlet , 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

ServiceController

Puede canalizar un objeto de servicio a este cmdlet.

String

Puede canalizar una cadena que contenga un nombre de servicio a este cmdlet.

Salidas

None

De forma predeterminada, este cmdlet no devuelve ninguna salida.

ServiceController

Cuando se usa el parámetro PassThru , este cmdlet devuelve un objeto ServiceController que representa el servicio reiniciado.

Notas

Este cmdlet solo está disponible en plataformas Windows.

  • 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 .