Restart-Computer (Microsoft.PowerShell.Management)

Restart-Computer

Módulo:

Microsoft.PowerShell.Management

Reinicia el sistema operativo en computadoras locales y remotas.

Sintaxis

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

Descripción

Este cmdlet solo está disponible en la plataforma Windows.

El cmdlet Restart-Computer reinicia el sistema operativo en las computadoras locales y remotas.

Puede utilizar los parámetros de Restart-Computer para ejecutar las operaciones de reinicio, especificar los niveles de autenticación y 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 la computadora reiniciada. Esta característica hace que sea práctico utilizar Restart-Computer en scripts y funciones.

Ejemplos

Ejemplo 1: reiniciar la computadora local

Restart-Computer reinicia la computadora local.

Restart-Computer

Ejemplo 2: reiniciar varias computadoras

Restart-Computer puede reiniciar computadoras remotas y locales. El parámetro ComputerName acepta una serie de nombres de computadoras.

Restart-Computer -ComputerName Server01, Server02, localhost

Ejemplo 3: obtener nombres de computadoras de un archivo de texto

Restart-Computer obtiene una lista de nombres de computadoras de un archivo de texto y reinicia las computadoras. El parámetro ComputerName no está especificado. Pero debido a que es el primer parámetro de posición, acepta los nombres de las computadoras del archivo de texto que se envían por el proceso.

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

Get-Content utiliza el parámetro Path para obtener una lista de nombres de computadoras de un archivo de texto, Domain01.txt. Los nombres de las computadoras se envían por el proceso. Restart-Computer reinicia cada computadora.

Ejemplo 4: forzar el reinicio de las computadoras enumeradas en un archivo de texto

Este ejemplo fuerza un reinicio inmediato de las computadoras enumeradas en el archivo Domain01.txt. Los nombres de las computadoras 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 computadoras de un archivo de texto, Domain01.txt. Los nombres de las computadoras se almacenan en la variable $Names. Get-Credential le solicita un nombre de usuario y contraseña y almacena los valores en la variable $Creds. Restart-Computer utiliza los parámetros ComputerName y Credential con sus variables. El parámetro Force provoca un reinicio inmediato de cada computadora.

Ejemplo 6: reiniciar una computadora remota y esperar PowerShell

Restart-Computer reinicia la computadora remota y luego espera hasta 5 minutos (300 segundos) para que PowerShell esté disponible en la computadora reiniciada antes de continuar.

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

Restart-Computer utiliza 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 la computadora remota. El parámetro Timeout especifica una espera de cinco minutos. El parámetro Delay consulta la computadora remota cada dos segundos para determinar si se ha reiniciado.

Ejemplo 7: reiniciar una computadora usando WsmanAuthentication

Restart-Computer reinicia la computadora remota usando el mecanismo WsmanAuthentication. La autenticación Kerberos determina si el usuario actual tiene permiso para reiniciar la computadora remota. Para obtener más información, consulte Mecanismo de autenticación.

Restart-Computer -ComputerName Server01 -WsmanAuthentication Kerberos

Restart-Computer utiliza el parámetro ComputerName para especificar la computadora remota, Server01. El parámetro WsmanAuthentication especifica el método de autenticación como Kerberos.

Parámetros

-ComputerName

Especifica un nombre de computadora o una matriz de nombres de computadora separados por comas. Restart-Computer acepta objetos ComputerName de la canalización o variables.

Escriba el nombre NetBIOS, una dirección IP o un nombre de dominio completo de una computadora remota. Para especificar la computadora local, escriba el nombre de la computadora, un punto . o localhost.

Este parámetro no depende de la comunicación remota de PowerShell. Puede utilizar el parámetro ComputerName incluso si su computadora no está configurada para ejecutar comandos remotos.

Si no se especifica el parámetro ComputerName, Restart-Computer reinicia la computadora local.

Tipo :

String[]

Alias:

CN, __SERVER, Server, IPAddress

Posición:

0

Valor predeterminado:

None

Requerido:

False

Aceptar entrada de canalización:

True

Aceptar caracteres comodín:

False

-Confirm

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

Tipo :

SwitchParameter

Alias:

cf

Posición:

Nombrado

Valor predeterminado:

False

Requerido:

False

Aceptar entrada de canalización:

False

Aceptar caracteres comodín:

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 Usuario01 o Dominio01\Usuario01, o introduzca un objeto PSCredential generado por Get-Credential. código> cmdlet. Si escribe un nombre de usuario, se le pedirá que ingrese la contraseña.

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

Tipo :

PSCredencial

Posición:

1

Valor predeterminado:

Usuario actual

Requerido:

False

Aceptar entrada de canalización:

False

Aceptar caracteres comodín:

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 la computadora.

Este parámetro sólo 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.

Tipo :

Int16

Posición:

Nombrado

Valor predeterminado:

None

Requerido:

False

Aceptar entrada de canalización:

False

Aceptar caracteres comodín:

False

-For

Especifica el comportamiento de PowerShell mientras espera que el servicio o característica especificado esté disponible después de que se reinicie la computadora. Este parámetro sólo es válido con el parámetro Espera.

Los valores aceptables para este parámetro son:

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

Este parámetro se introdujo en Windows PowerShell 3.0.

Tipo :

Esperar tipos de servicio

Valores aceptados:

Wmi, WinRM, PowerShell

Posición:

Nombrado

Valor predeterminado:

None

Requerido:

False

Aceptar entrada de canalización:

False

Aceptar caracteres comodín:

False

-Force

Fuerza un reinicio inmediato del ordenador.

Tipo :

SwitchParameter

Alias:

f

Posición:

Nombrado

Valor predeterminado:

None

Requerido:

False

Aceptar entrada de canalización:

False

Aceptar caracteres comodín:

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, incluso si las computadoras no se reinician.

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

Este parámetro se introdujo en Windows PowerShell 3.0.

Tipo :

Int32

Alias:

TimeoutSec

Posición:

Nombrado

Valor predeterminado:

None

Requerido:

False

Aceptar entrada de canalización:

False

Aceptar caracteres comodín:

False

-Wait

Restart-Computer suprime el mensaje de PowerShell y bloquea la canalización hasta que las computadoras se hayan reiniciado. Puede utilizar este parámetro en un script para reiniciar las computadoras y luego continuar con el proceso cuando finalice el reinicio.

El parámetro Wait espera indefinidamente a que se reinicien las computadoras. Puede utilizar 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 Esperar no es válido cuando reinicias la computadora local. Si el valor del parámetro ComputerName contiene los nombres de las computadoras remotas y la computadora local, Restart-Computer genera un error que no termina para Esperar en la computadora local, pero espera a que se reinicien las computadoras remotas.

Este parámetro se introdujo en Windows PowerShell 3.0.

Tipo :

SwitchParameter

Posición:

Nombrado

Valor predeterminado:

None

Requerido:

False

Aceptar entrada de canalización:

False

Aceptar caracteres comodín:

False

-WhatIf

Muestra lo que sucedería si se ejecuta Restart-Computer. El cmdlet Restart-Computer no se ejecuta.

Tipo :

SwitchParameter

Alias:

wi

Posición:

Nombrado

Valor predeterminado:

False

Requerido:

False

Aceptar entrada de canalización:

False

Aceptar caracteres comodín:

False

-WsmanAuthentication

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

Los valores aceptables para este parámetro son: Básico, CredSSP, Default, Digest, Kerberos y Negociar.

Para obtener más información, consulte Mecanismo de autenticación.

Tipo :

String

Valores aceptados:

Básico, CredSSP, Predeterminado, Resumen, Kerberos, Negociar

Posición:

Nombrado

Valor predeterminado:

None

Requerido:

False

Aceptar entrada de canalización:

False

Aceptar caracteres comodín:

False

Entradas

Cadena

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

Salidas

Ninguno

Este cmdlet no devuelve ningún resultado.

Notas

• En Windows, Restart-Computer utiliza el método Win32Shutdown de la clase Win32_OperatingSystem del Instrumental de administración de Windows (WMI). Este método requiere que el privilegio SeShutdownPrivilege esté habilitado para la cuenta de usuario utilizada para reiniciar la máquina.
• En Linux y Mac OS, Restart-Computer utiliza la herramienta bash /sbin/shutdown.