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




Tabla de contenido