Detiene (apaga) los equipos local y remotos.

Sintaxis

Stop-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 Stop-Computer apaga los equipos remotos. También puede apagar el equipo local.

Puede utilizar los parámetros de Stop-Computer para ejecutar las operaciones de apagado como un trabajo en segundo plano, para especificar los niveles de autenticación y las credenciales alternativas, para limitar las conexiones simultáneas que se crean para ejecutar el comando, y para forzar un apagado 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. (Stop-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[]>

Detiene los equipos especificados. El valor predeterminado es el equipo local.

Escriba el nombre NETBIOS, la dirección IP o el nombre de dominio completo de uno o varios equipos en una lista de valores separados por comas. Para especificar el equipo local, escriba el nombre del equipo o "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 un apagado 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. (Stop-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 se 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 utiliza el parámetro AsJob, el cmdlet devuelve un objeto de trabajo (System.Management.Automation.RemotingJob). De lo contrario, no genera resultados.

Notas

Este cmdlet utiliza el método Win32Shutdown de la clase WMI Win32_OperatingSystem.

Ejemplo 1

C:\PS>stop-computer

Descripción
-----------
Este comando apaga el equipo local.






Ejemplo 2

C:\PS>stop-computer -computername Server01, Server02, localhost

Descripción
-----------
Este comando detiene dos equipos remotos, Server01 y Server02, y el equipo local, identificado como "localhost".






Ejemplo 3

C:\PS>$j = stop-computer -computername Server01, Server02 -asjob 

C:\PS> $results = $j | receive-job

C:\PS> $results

Descripción
-----------
Estos comandos ejecutan un comando Stop-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>stop-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> stop-computer -computername $s -force -throttlelimit 10 -credential $c

Descripción
-----------
Estos comandos fuerzan el apagado 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 apaga los equipos. Utiliza el parámetro ComputerName para enviar la lista de equipos de la variable $s, el parámetro Force para forzar un apagado 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




Tabla de contenido