Quite el equipo local de un grupo de trabajo o dominio.
Sintaxis
Remove-Computer [[-Credential] <PSCredential>] [-Force] [-PassThru] [-Confirm] [-WhatIf] [<CommonParameters>]
Descripción
El cmdlet Remove-Computer quita el equipo local del grupo de trabajo o dominio actual.
Cuando se quita un equipo de un dominio, Remove-Computer también deshabilita la cuenta de dominio del equipo.
Cuando el equipo está en un dominio, se deben proporcionar credenciales, aunque sean las credenciales del usuario actual, y se debe reiniciar el equipo para que el cambio surta efecto.
Para obtener los resultados del comando, utilice los parámetros Verbose y PassThru.
Parámetros
-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 generado por el cmdlet Get-Credential. Si escribe un nombre de usuario se le pedirá una contraseña.
Para quitar un equipo de un dominio, debe utilizar el parámetro Credential, aunque esté utilizando las credenciales del usuario actual.
|
¿Requerido? |
false |
|
¿Posición? |
2 |
|
Valor predeterminado |
The credentials of the current user |
|
¿Aceptar canalización? |
false |
|
¿Aceptar caracteres comodín? |
false |
-Force
|
¿Requerido? |
false |
|
¿Posición? |
named |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
false |
|
¿Aceptar caracteres comodín? |
false |
-PassThru
Devuelve los resultados del comando. En caso contrario, este cmdlet no genera resultados.
|
¿Requerido? |
false |
|
¿Posición? |
named |
|
Valor predeterminado |
|
|
¿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 se pueden canalizar entradas a este cmdlet. |
|
Salidas |
Microsoft.PowerShell.Commands.ComputerChangeInfo Cuando se usa el parámetro PassThru, Remove-Computer devuelve un objeto ComputerChangeInfo. En caso contrario, este cmdlet no genera resultados. |
Ejemplo 1
C:\PS>remove-computer Descripción ----------- Este comando quita el equipo de un grupo de trabajo.
Ejemplo 2
C:\PS>remove-computer -credential domain01\admin01 -passthru -verbose; restart-computer Descripción ----------- Estos comandos quitan el equipo local del dominio al que está unido. El primer comando quita el equipo del dominio. El comando utiliza el parámetro Credential para proporcionar las credenciales de un administrador de dominio. Utiliza el parámetro PassThru y el parámetro común Verbose para mostrar información sobre la ejecución correcta o incorrecta del comando. El segundo comando usa el cmdlet Restart-Computer para reiniciar el equipo, que se requiere para completar la operación de eliminación. El signo de punto y coma (;) separa los dos comandos.
Vea también