Reinicia el sistema operativo en equipos locales y remotos.
- Sintaxis
- Descripción
- Ejemplos
- Ejemplo 1: Reinicie el equipo local
- Ejemplo 2: Reiniciar varios equipos
- Ejemplo 3: Obtener nombres de equipo de un archivo de texto
- Ejemplo 4: Forzar el reinicio de los equipos enumerados en un archivo de texto
- Ejemplo 6: Reinicie un equipo remoto y espere a que PowerShell
- Ejemplo 7: Reinicie un equipo mediante WsmanAuthentication
- Parámetros
- Inputs
- Outputs
- Notas
Sintaxis
Descripción
El cmdlet Restart-Computer reinicia el sistema operativo en los equipos locales y remotos.
Puede utilizar 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 comando siguiente. 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 hace que sea práctico usar inscripciones y funciones Restart-Computer.
Ejemplos
Ejemplo 1: Reinicie el equipo local
Restart-Computer reinicia el equipo local.
Restart-ComputerEjemplo 2: Reiniciar varios equipos
Restart-Computer puede reiniciar equipos remotos y locales. El parámetro ComputerName acepta una serie de nombres de equipo.
Restart-Computer -ComputerName Server01, Server02, localhostEjemplo 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 Nombre de la computadora no está especificado. Pero debido a que es el primer parámetro de posición, acepta los nombres de los equipos del archivo de texto que se envían por la canalización.
Get-Content -Path C:\Domain01.txt | Restart-ComputerGet-Content utiliza el parámetro Path para obtener una lista de nombres de equipo de un archivo de texto,Domain01.txt. Los nombres de las computadoras se envían por la canalización. Restart-Computer reinicia cada ordenador.
Ejemplo 4: Forzar el reinicio de los equipos enumerados en un archivo de texto
Este ejemplo fuerza el reinicio inmediato de los equipos enumerados en el archivo Domain01.txt. Los nombres de los ordenadores del archivo de texto se almacenan en una variable. El parámetro Force fuerza el reinicio de animmediate.
Get-Content utiliza el parámetro Path para obtener una lista de nombres de equipo de un archivo de texto,Domain01.txt. Los nombres de los equipos se almacenan en la variable $NamesGet-Credential le pide un nombre de usuario y una contraseña y almacena los valores en la variable $CredsRestart-Computer utiliza los parámetros ComputerName y Credential con sus variables. El Forceparámetro provoca un reinicio inmediato de cada equipo.
Ejemplo 6: Reinicie un equipo remoto y espere a que PowerShell
Restart-Computer reinicie el equipo remoto y, a continuación, espere hasta 5 minutos (300 segundos) para que PowerShell esté disponible en el equipo reiniciado antes de que continúe.
Restart-Computer -ComputerName Server01 -Wait -For PowerShell -Timeout 300 -Delay 2 Restart-Computer utiliza el parámetro ComputerName para especificar Server01. El Waitparameter espera a que finalice el reinicio. El For especifica que PowerShell puede ejecutar comandos en el equipo remoto. El parámetro Tiempo de espera especifica una espera de cinco minutos. El parámetro de retardo consulta el equipo remoto cada dos segundos para determinar si se reinicia.
Ejemplo 7: Reinicie un equipo mediante WsmanAuthentication
Restart-Computer reinicia el equipo remoto mediante el mecanismo de autenticación WSMan.La autenticación Kerberos determina si el usuario actual tiene permiso para reiniciar el remotecomputer. Para obtener más información, consulte el Mecanismo de autenticación.
Restart-Computer -ComputerName Server01 -WsmanAuthentication KerberosRestart-Computer utiliza 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
Especifica un nombre de equipo o separados por comas matriz de nombres de equipo. Restart-Computer Acepta objetos de nombre de computadora de la canalización 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 depende de la comunicación remota de PowerShell. Puede usar el parámetro ComputerName even si el equipo no está configurado para ejecutar comandos remotos.
Si no se especifica el parámetro ComputerName, Restart-Computer reinicia el equipo local.
| Tipo: | String |
| Alias: | CN, __SERVER, Servidor, dirección ip |
| Posición: | 0 |
| valor Predeterminado: | None |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
Prompts you for confirmation before running Restart-Computer.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
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 introduzca un objeto PSCredential generado por el cmdlet Get-Credential. Si escribes un nombre de usuario, se te pedirá que introduzcas la contraseña.
Las credenciales se almacenan en un objeto PSCredential y la contraseña se almacena como una cadena de seguridad.
Note
For more information about SecureString data protection, seeHow secure is SecureString?.
| Type: | PSCredential |
| Position: | 1 |
| Default value: | Current user |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Specifies the frequency of queries, in seconds. 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 es válido solo 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 de retardo, Restart-Computer utiliza un retardo de cinco segundos.
| Tipo: | Int16 |
| Cargo: | Nombre |
| valor Predeterminado: | Ninguno |
| Aceptar tubería de entrada: | False |
| Aceptar caracteres comodín: | False |
Especifica el comportamiento de PowerShell como se espera para el servicio especificado o función a becomeavailable 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 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.
| Tipo: | WaitForServiceTypes |
| valores Aceptados: | Wmi, WinRM, PowerShell |
| Posición: | Nombre |
| valor Predeterminado: | Ninguno |
| Aceptar tubería de entrada: | False |
| Aceptar caracteres comodín: | False |
Forces an immediate restart of the computer.
| Type: | SwitchParameter |
| Aliases: | f |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Specifies the duration of the wait, in seconds. Cuando transcurre el tiempo de espera, Restart-Computer devuelve al símbolo del sistema, incluso si los equipos no se reinician.
El parámetro Timeout solo es válido con el parámetro Wait. Timeout anula el período de espera indefinido del parámetro Wait.
Este parámetro se introdujo en Windows PowerShell 3.0.
| Tipo: | Int32 |
| Alias: | TimeoutSec |
| Cargo: | Nombre |
| valor por Defecto: | Ninguno |
| Aceptar tubería de entrada: | False |
| Aceptar caracteres comodín: | False |
Restart-Computer suprime el PowerShell y los bloques de la tubería hasta que los equipos haverestarted. Puede usar este parámetro en un script para reiniciar equipos y, a continuación, continuar con el proceso cuando finalice el reinicio.
El parámetro Wait espera indefinidamente a que los equipos se reinicien. Puede utilizar el tiempo de espera para ajustar el tiempo y los parámetros de Espera y retardo 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 Nombre de la computadora contiene los nombres de los equipos remotos y el equipo local,Restart-Computer genera un error de no terminación para Esperar en el equipo local, pero espera a que los equipos remotos se reinicien.
Este parámetro se introdujo en Windows PowerShell 3.0.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Shows what would happen if the Restart-Computer runs. The Restart-Computer cmdlet isn’t run.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Nombre |
| valor Predeterminado: | False |
| Aceptar tubería de entrada: | False |
| Aceptar caracteres comodín: | False |
Especifica el mecanismo que se utiliza 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,Kerberos y Negotiate.
Para obtener más información, consulte Mecanismo de autenticación.
Advertencia
La autenticación de Proveedor de servicios de seguridad de credenciales (CredSSP), en la que las credenciales de usuario se envían a un equipo remoto para autenticarse, está diseñada para comandos que requieren autenticación en más de un recurso, como acceder a un recurso compartido de red remoto. Este mecanismo reduce el riesgo de seguridad de la operación remota. Si el equipo remoto está comprometido, los credenciales que se le pasan se pueden usar para controlar la sesión de red.
| Tipo: | String |
| valores Aceptados: | Basic, CredSSP, Default, Digest, Kerberos, Negotiate |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Inputs
String
Restart-Computer accepts computer names from the pipeline or variables.
Outputs
None
Restart-Computer doesn’t generate any output.
Notas
- En Windows,
Restart-Computerutiliza el método Win32Shutdown de la clase Win32_OperatingSystem de Windows Management Instrumentation (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-Computerutiliza la herramienta bash/sbin/shutdown.
- Acerca de la Administración Remota de Windows
- Get-Credential
- Protocolo WS-Management