Compartir vía

Restart-Computer

Módulo:
Microsoft.PowerShell.Management Module

Reinicia el sistema operativo en equipos locales y remotos.

Sintaxis

DefaultSet (Es el valor predeterminado). 

Restart-Computer
    [[-ComputerName] <String[]>]
    [-WsmanAuthentication <String>]
    [-Credential]<PSCredential>]
    [-Force]
    [-Wait]
    [-Timeout <Int32>]
    [-For <WaitForServiceTypes>]
    [-Delay <Int16>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

El cmdlet Restart-Computer reinicia el sistema operativo en los equipos locales y remotos.

Puede usar los parámetros de Restart-Computer para ejecutar las operaciones de reinicio, especificar los niveles de autenticación y las credenciales alternativas, limitar las operaciones que se ejecutan al mismo tiempo y forzar un reinicio inmediato.

A partir de Windows PowerShell 3.0, puede esperar a que se complete el reinicio antes de ejecutar el siguiente comando. Especifique un tiempo de espera y un intervalo de consulta y espere a que determinados servicios estén disponibles en el equipo reiniciado. Esta característica facilita el uso de Restart-Computer en scripts y funciones.

En PowerShell 7.1, Restart-Computer se agregó para Linux y macOS. Las plataformas que no son de Windows solo tienen los parámetros WhatIf, Confirm y CommonParameters . El cmdlet simplemente llama al comando nativo /sbin/shutdown.

Ejemplos

Ejemplo 1: Reiniciar el equipo local

Restart-Computer reinicia el equipo local.

Restart-Computer

Ejemplo 2: Reinicio de varios equipos

Restart-Computer puede reiniciar equipos remotos y locales. El parámetro ComputerName acepta una matriz de nombres de equipo.

Restart-Computer -ComputerName Server01, Server02, localhost

Ejemplo 3: Obtener nombres de equipo de un archivo de texto

Restart-Computer obtiene una lista de nombres de equipo de un archivo de texto y reinicia los equipos. El parámetro ComputerName no se especifica. Pero como es el primer parámetro de posición, acepta los nombres de ordenador del archivo de texto que se envían por la pipeline.

Get-Content -Path C:\Domain01.txt | Restart-Computer

Get-Content utiliza el parámetro Path para obtener una lista de nombres de equipos de un archivo de texto, Dominio01.txt. Los nombres de los ordenadores se envían por la pipeline. Restart-Computer reinicia cada equipo.

Ejemplo 4: Forzar el reinicio de equipos enumerados en un archivo de texto

En este ejemplo se fuerza un reinicio inmediato de los equipos enumerados en el archivo Domain01.txt. Los nombres de equipo del archivo de texto se almacenan en una variable. El parámetro Force fuerza un reinicio inmediato.

$Names = Get-Content -Path C:\Domain01.txt
$Creds = Get-Credential
Restart-Computer -ComputerName $Names -Credential $Creds -Force

Get-Content utiliza el parámetro Path para obtener una lista de nombres de equipos de un archivo de texto, Dominio01.txt. Los nombres de equipo se almacenan en la variable $Names. Get-Credential le pide un nombre de usuario y una contraseña y almacena los valores en la variable $Creds. Restart-Computer usa los parámetros de ComputerName y Credential con sus variables. El parámetro Force provoca un reinicio inmediato de cada equipo.

Ejemplo 6: Reiniciar un equipo remoto y esperar a PowerShell

Restart-Computer reinicia el equipo remoto y, a continuación, espera hasta 5 minutos (300 segundos) para que PowerShell esté disponible en el equipo reiniciado antes de continuar.

Restart-Computer -ComputerName Server01 -Wait -For PowerShell -Timeout 300 -Delay 2

Restart-Computer usa el parámetro ComputerName para especificar Server01. El parámetro Wait espera a que finalice el reinicio. El For especifica que PowerShell puede ejecutar comandos en el equipo remoto. El parámetro Timeout especifica una espera de cinco minutos. El parámetro Delay consulta el equipo remoto cada dos segundos para determinar si ha sido reiniciado.

Ejemplo 7: Reinicio de un equipo mediante WsmanAuthentication

Restart-Computer reinicia el equipo remoto utilizando el mecanismo WsmanAuthentication. La autenticación Kerberos determina si el usuario actual tiene permiso para reiniciar el equipo remoto. Para obtener más información, vea AuthenticationMechanism.

Restart-Computer -ComputerName Server01 -WsmanAuthentication Kerberos

Restart-Computer usa el parámetro computerName para especificar el equipo remoto, Server01. El parámetro WsmanAuthentication especifica el método de autenticación como Kerberos.

Parámetros

-ComputerName

Especifica un nombre de equipo o una matriz separada por comas de nombres de equipo. Restart-Computer acepta objetos ComputerName de la pipeline o variables.

Escriba el nombre NetBIOS, una dirección IP o un nombre de dominio completo de un equipo remoto. Para especificar el equipo local, escriba el nombre del equipo, un punto .o localhost.

Este parámetro no utiliza la comunicación remota de PowerShell. Puede usar el parámetro ComputerName incluso si el equipo no está configurado para ejecutar comandos remotos.

Si no se especifica el parámetro computerName , Restart-Computer reinicia el equipo local.

Este parámetro solo está disponible en plataformas Windows.

Propiedades del parámetro

Tipo:

String[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:CN, __SERVIDOR, Servidor, dirección IP

Conjuntos de parámetros

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

-Confirm

Le pide confirmación antes de ejecutar Restart-Computer.

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

-Credential

Especifica una cuenta de usuario que tiene permiso para realizar esta acción. El valor predeterminado es el usuario actual.

Escriba un nombre de usuario, como User01 o Domain01\User01, o escriba un objeto de PSCredential generado por el cmdlet Get-Credential. Si escribe un nombre de usuario, se le pedirá que escriba la contraseña.

Las credenciales se almacenan en un objeto PSCredential y la contraseña se almacena como SecureString.

Nota:

Para obtener más información sobre la protección de datos de SecureString, consulte ¿Qué tan segura es SecureString?.

Este parámetro solo está disponible en plataformas Windows.

Propiedades del parámetro

Tipo:PSCredential
Valor predeterminado:Current user
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

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

-Delay

Especifica la frecuencia de las consultas, en segundos. PowerShell consulta el servicio especificado por el parámetro For para determinar si el servicio está disponible después de reiniciar el equipo.

Este parámetro solo es válido junto con los parámetros Wait y For.

Este parámetro se introdujo en Windows PowerShell 3.0.

Si no se especifica el parámetro Delay, Restart-Computer utiliza un retraso de cinco segundos.

Este parámetro solo está disponible en plataformas Windows.

Propiedades del parámetro

Tipo:Int16
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

-For

Especifica el comportamiento de PowerShell a medida que espera a que el servicio o la característica especificados estén disponibles después de reiniciar el equipo. Este parámetro solo es válido con el parámetro Wait.

Los valores aceptables para este parámetro son:

  • predeterminado: espera a que PowerShell se reinicie.
  • powerShell: puede ejecutar comandos en una sesión remota de PowerShell en el equipo.
  • WMI: recibe una respuesta a una consulta de Win32_ComputerSystem para el equipo.
  • WinRM: puede establecer una sesión remota en el equipo mediante WS-Management.

Este parámetro se introdujo en Windows PowerShell 3.0. Este parámetro solo está disponible en plataformas Windows.

Propiedades del parámetro

Tipo:WaitForServiceTypes
Valor predeterminado:None
Valores aceptados:Wmi, WinRM, PowerShell
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

-Force

Fuerza un reinicio inmediato del equipo.

Este parámetro solo está disponible en plataformas Windows.

Propiedades del parámetro

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

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

-Timeout

Especifica la duración de la espera, en segundos. Cuando transcurre el tiempo de espera, Restart-Computer vuelve al símbolo del sistema, aunque no se reinicien los equipos.

El parámetro Timeout solo es válido con el parámetro Esperar. Timeout invalida el período de espera indefinido del parámetro Wait.

Este parámetro se introdujo en Windows PowerShell 3.0.

Este parámetro solo está disponible en plataformas Windows.

Propiedades del parámetro

Tipo:Int32
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:TimeoutSec

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

-Wait

Restart-Computer suprime el símbolo del sistema de PowerShell y bloquea el pipeline hasta que se han reiniciado los equipos. Puede usar este parámetro en un script para reiniciar equipos y, a continuación, continuar procesando cuando finalice el reinicio.

El parámetro Wait espera indefinidamente para que los equipos se reinicien. Puede usar el Timeout para ajustar el tiempo y los parámetros For y Delay para esperar a que determinados servicios estén disponibles en los equipos reiniciados.

El parámetro Wait no es válido cuando se reinicia el equipo local. Si el valor del parámetro ComputerName contiene los nombres de los ordenadores remotos y del ordenador local, Restart-Computer genera un error no terminal para Wait en el ordenador local, pero espera a que se reinicien los ordenadores remotos.

Este parámetro se introdujo en Windows PowerShell 3.0. Este parámetro solo está disponible en plataformas Windows.

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 ocurriría si se ejecuta Restart-Computer. El cmdlet Restart-Computer 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

-WsmanAuthentication

Especifica el mecanismo que se usa para autenticar las credenciales de usuario. Este parámetro se introdujo en Windows PowerShell 3.0.

Los valores aceptables para este parámetro son: Basic, CredSSP, Default, Digest, Kerberosy Negotiate.

Para obtener más información, vea AuthenticationMechanism.

Advertencia

La autenticación del proveedor de servicios de seguridad de credenciales (CredSSP), en la que las credenciales de usuario se pasan a un equipo remoto para autenticarse, está diseñada para comandos que requieren autenticación en más de un recurso, como el acceso a un recurso compartido de red remoto. Este mecanismo aumenta el riesgo de seguridad de la operación remota. Si el equipo remoto está en peligro, se pueden usar las credenciales que se pasan a ella para controlar la sesión de red.

Este parámetro solo está disponible en plataformas Windows.

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Valores aceptados:Basic, CredSSP, Default, Digest, Kerberos, Negotiate
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

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

String

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

Salidas

None

Este cmdlet no devuelve ninguna salida.

Notas

  • En Windows, Restart-Computer usa el método Win32Shutdown de la clase Win32_OperatingSystem de la Instrumentación de Administración de Windows (WMI). Este método requiere que se habilite el privilegio SeShutdownPrivilege para la cuenta de usuario que se utiliza para reiniciar el equipo.
  • Este cmdlet se agregó para Linux y macOS en PowerShell 7.1. En Linux y macOS, Restart-Computer usa la herramienta bash de /sbin/shutdown.