Compartir a través de

Restart-Service

Módulo:
Microsoft.PowerShell.Management Module

Detiene e inicia uno o varios servicios.

Sintaxis

InputObject (Es el valor predeterminado). 

Restart-Service
    [-InputObject] <ServiceController[]>
    [-Force]
    [-PassThru]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Default 

Restart-Service
    [-Name] <String[]>
    [-Force]
    [-PassThru]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

DisplayName 

Restart-Service
    -DisplayName <String[]>
    [-Force]
    [-PassThru]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Este cmdlet solo está disponible en la plataforma Windows.

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 ya se ha detenido un servicio, se inicia sin notificarle un 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 desee 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 inicia 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 pide confirmación antes de ejecutar el cmdlet.

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:False
Admite caracteres comodín:False
DontShow:False
Alias:cf

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-DisplayName

Especifica los nombres para mostrar de los servicios que se reiniciarán. Se permite el uso de caracteres comodín.

Propiedades del parámetro

Tipo:

String[]

Valor predeterminado:None
Admite caracteres comodín:True
DontShow:False

Conjuntos de parámetros

DisplayName
Posición:Named
Mandatory:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Exclude

Especifica los servicios que este cmdlet omite. El valor de este parámetro condiciona el parámetro Name. Escriba un elemento de nombre o patrón, como s*. Se permite el uso de caracteres comodín.

Propiedades del parámetro

Tipo:

String[]

Valor predeterminado:None
Admite caracteres comodín:True
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Force

Obliga a que el comando se ejecute sin pedir confirmación del usuario.

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Include

Especifica los servicios que este cmdlet reinicia. El valor de este parámetro condiciona el parámetro Name. Escriba un elemento de nombre o patrón, como s*. Se permite el uso de caracteres comodín.

Propiedades del parámetro

Tipo:

String[]

Valor predeterminado:None
Admite caracteres comodín:True
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-InputObject

Especifica ServiceController objetos que representan los servicios que se van a reiniciar. Escriba una variable que contenga los objetos, o escriba un comando o expresión que obtenga los objetos.

Propiedades del parámetro

Tipo:

ServiceController[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

InputObject
Posición:0
Mandatory:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Name

Especifica los nombres de servicio de los servicios que se van a reiniciar.

Propiedades del parámetro

Tipo:

String[]

Valor predeterminado:None
Admite caracteres comodín:True
DontShow:False
Alias:NombreDelServicio

Conjuntos de parámetros

Default
Posición:0
Mandatory:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-PassThru

Devuelve un objeto que representa el servicio. De forma predeterminada, este cmdlet no genera ninguna salida.

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-WhatIf

Muestra lo que sucedería si el cmdlet se ejecuta. El cmdlet no se ejecuta.

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:False
Admite caracteres comodín:False
DontShow:False
Alias:Wi

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

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, es posible que no tenga 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 Name y los nombres para mostrar aparecen en la columna DisplayName.