Reinicia el sistema operativo en los equipos local y remotos.
Sintaxis
Restart-Computer [[-ComputerName] <string[]>] [[-Credential] <PSCredential>] [-AsJob] [-Authentication {<Default> | <None> | <Connect> | <Call> | <Packet> | <PacketIntegrity> | <PacketPrivacy> | <Unchanged>}] [-Force] [-Impersonation {<Default> | <Anonymous> | <Identify> | <Impersonate> | <Delegate>}] [-ThrottleLimit <int>] [-Confirm] [-WhatIf] [<CommonParameters>]
Descripción
El cmdlet Restart-Computer reinicia el sistema operativo en los equipos local y remotos.
Puede utilizar los parámetros de Restart-Computer para ejecutar las operaciones de reinicio como un trabajo en segundo plano, para especificar los niveles de autenticación y las credenciales alternativas, para limitar las operaciones que se ejecutan simultáneamente y para forzar un reinicio inmediato.
Este cmdlet no requiere la comunicación remota de Windows PowerShell a menos que se utilice el parámetro AsJob.
Parámetros
-AsJob
Ejecuta el comando como un trabajo en segundo plano.
Nota: para utilizar este parámetro, el equipo local y los equipos remotos deben estar configurados para la comunicación remota y, en Windows Vista y versiones posteriores de Windows, se debe abrir Windows PowerShell con la opción "Ejecutar como administrador". Para obtener más información, vea about_Remote_Requirements.
Cuando se utiliza el parámetro AsJob, el comando devuelve inmediatamente un objeto que representa el trabajo en segundo plano. Puede seguir trabajando en la sesión mientras se completa el trabajo. El trabajo se crea en el equipo local y los resultados de los equipos remotos se devuelven automáticamente al equipo local. Para administrar el trabajo, use los cmdlets Job. Para obtener los resultados del trabajo, use el cmdlet Receive-Job.
Para obtener más información sobre los trabajos en segundo plano en Windows PowerShell, vea about_Jobs y about_Remote_Jobs.
|
¿Requerido? |
false |
|
¿Posición? |
named |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
false |
|
¿Aceptar caracteres comodín? |
false |
-Authentication <AuthenticationLevel>
Especifica el nivel de autenticación que se utiliza para la conexión de WMI. (Restart-Computer utiliza WMI). El valor predeterminado es Packet.
Los valores válidos son:
Unchanged: el nivel de autenticación es idéntico al del comando anterior.
Default: autenticación de Windows
None: ninguna autenticación COM
Connect: autenticación COM en el nivel de conexión
Call: autenticación COM en el nivel de llamada
Packet: autenticación COM en el nivel de paquete.
PacketIntegrity: autenticación COM en el nivel de integridad de paquete
PacketPrivacy: autenticación COM en el nivel de privacidad de paquete.
|
¿Requerido? |
false |
|
¿Posición? |
named |
|
Valor predeterminado |
4 |
|
¿Aceptar canalización? |
false |
|
¿Aceptar caracteres comodín? |
false |
-ComputerName <string[]>
Especifica uno o varios equipos remotos. El valor predeterminado es el equipo local.
Escriba el nombre NETBIOS, la dirección IP o el nombre de dominio completo de un equipo remoto. Para especificar el equipo local, escriba el nombre del equipo, un punto (.), o bien, "localhost".
Este parámetro no se basa en la comunicación remota de Windows PowerShell. Puede usar el parámetro ComputerName incluso si el equipo no está configurado para la ejecución de comandos remotos.
|
¿Requerido? |
false |
|
¿Posición? |
1 |
|
Valor predeterminado |
. |
|
¿Aceptar canalización? |
true (ByPropertyName) |
|
¿Aceptar caracteres comodín? |
false |
-Credential <PSCredential>
Especifica una cuenta de usuario con permiso para realizar esta acción. El valor predeterminado es el usuario actual.
Escriba un nombre de usuario, como "Usuario01" o "Dominio01\Usuario01", o bien, escriba un objeto PSCredential, como uno del cmdlet Get-Credential.
|
¿Requerido? |
false |
|
¿Posición? |
2 |
|
Valor predeterminado |
Current user |
|
¿Aceptar canalización? |
false |
|
¿Aceptar caracteres comodín? |
false |
-Force
Fuerza el reinicio inmediato de los equipos.
|
¿Requerido? |
false |
|
¿Posición? |
named |
|
Valor predeterminado |
False |
|
¿Aceptar canalización? |
false |
|
¿Aceptar caracteres comodín? |
false |
-Impersonation <ImpersonationLevel>
Especifica el nivel de suplantación que se va a usar al llamar a WMI. (Restart-Computer utiliza WMI). El valor predeterminado es "Impersonate".
Los valores válidos son:
Default: suplantación predeterminada.
Anonymous: oculta la identidad del autor de llamada.
Identify: permite que los objetos consulten las credenciales del autor de llamada.
Impersonate: permite a los objetos utilizar las credenciales del autor de llamada.
|
¿Requerido? |
false |
|
¿Posición? |
named |
|
Valor predeterminado |
Impersonate |
|
¿Aceptar canalización? |
false |
|
¿Aceptar caracteres comodín? |
false |
-ThrottleLimit <int>
Especifica el número máximo de conexiones simultáneas que se pueden establecer para ejecutar este comando. Si omite este parámetro o escribe un valor 0, se utilizará el valor predeterminado 32.
Este límite se aplica únicamente al comando actual; no se aplica a la sesión ni al equipo.
|
¿Requerido? |
false |
|
¿Posición? |
named |
|
Valor predeterminado |
32 |
|
¿Aceptar canalización? |
false |
|
¿Aceptar caracteres comodín? |
false |
-Confirm
Solicita confirmación antes de ejecutar el comando.
|
¿Requerido? |
false |
|
¿Posición? |
named |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
false |
|
¿Aceptar caracteres comodín? |
false |
-WhatIf
Describe lo que ocurriría si ejecutara el comando sin ejecutarlo realmente.
|
¿Requerido? |
false |
|
¿Posición? |
named |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
false |
|
¿Aceptar caracteres comodín? |
false |
<CommonParameters>
Este cmdlet admite los parámetros comunes: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer y -OutVariable. Para obtener más información, vea about_Commonparameters.
Entradas y salidas
El tipo de entrada es el tipo de los objetos que se pueden canalizar al cmdlet. El tipo devuelto es el tipo de los objetos que el cmdlet devuelve.
|
Entradas |
Ninguno No puede canalizar entradas a este cmdlet. |
|
Salidas |
Ninguno o System.Management.Automation.RemotingJob Cuando se usa el parámetro AsJob, el cmdlet devuelve un objeto de trabajo. De lo contrario, no genera resultados. |
Notas
Este cmdlet utiliza el método Win32Shutdown de la clase WMI WIN32_OperatingSystem.
Ejemplo 1
C:\PS>restart-computer Descripción ----------- Este comando reinicia el equipo local.
Ejemplo 2
C:\PS>restart-computer -computername Server01, Server02, localhost Descripción ----------- Este comando reinicia dos equipos remotos, Server01 y Server02, y el equipo local, identificado como "localhost".
Ejemplo 3
C:\PS>$j = restart-computer -computername Server01, Server02 -asjob C:\PS> $results = $j | receive-job C:\PS> $results Descripción ----------- Estos comandos ejecutan un comando Restart-Computer como un trabajo en segundo plano en dos equipos remotos y, a continuación, obtienen los resultados. El primer comando utiliza el parámetro AsJob para ejecutar el comando como un trabajo en segundo plano. El comando guarda el objeto de trabajo resultante en la variable $j. El segundo comando usa un operador de canalización para enviar el objeto de trabajo en $j al cmdlet Receive-Job, que obtiene los resultados del trabajo. El comando guarda los resultados en la variable $results. El tercer comando muestra el resultado guardado en la variable $results. Dado que el parámetro AsJob crea el trabajo en el equipo local y devuelve automáticamente los resultados al equipo local, se puede ejecutar el comando Receive-Job como comando local.
Ejemplo 4
C:\PS>restart-computer -comp Server01 -impersonation anonymous -authentication PacketIntegrity Descripción ----------- Este comando reinicia el equipo remoto Server01. El comando utiliza la suplantación personalizada y la configuración de autenticación.
Ejemplo 5
C:\PS>$s = get-content domain01.txt C:\PS> $c = get-credential domain01\admin01 C:\PS> restart-computer -computername $s -force -throttlelimit 10 -credential $c Descripción ----------- Estos comandos fuerzan el reinicio inmediato de todos los equipos de Domain01. El primer comando obtiene una lista de los equipos del dominio y la guarda en la variable $s. El segundo comando obtiene las credenciales de un administrador de dominio y las guarda en la variable $c. El tercer comando reinicia los equipos. Utiliza el parámetro ComputerName para enviar la lista de equipos guardada en la variable $s, el parámetro Force para forzar el reinicio inmediato y el parámetro Credential para enviar las credenciales guardadas en la variable $c. También utiliza el parámetro ThrottleLimit para limitar el comando a 10 conexiones simultáneas.
Vea también