Remove-Computer
Quita el equipo local de su dominio.
Sintaxis
Remove-Computer
[[-UnjoinDomainCredential] <PSCredential>]
[-Restart]
[-Force]
[-PassThru]
[-WorkgroupName <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]Remove-Computer
-UnjoinDomainCredential <PSCredential>
[-LocalCredential <PSCredential>]
[-Restart]
[-ComputerName <String[]>]
[-Force]
[-PassThru]
[-WorkgroupName <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]Description
El cmdlet Remove-Computer quita el equipo local y los equipos remotos de sus dominios actuales.
Al quitar un equipo de un dominio, Remove-Computer también deshabilita la cuenta de dominio del equipo. Debe proporcionar credenciales explícitas para desenlazar el equipo desde su dominio, incluso cuando son las credenciales del usuario actual. Debe reiniciar el equipo para que el cambio sea efectivo. Además, al quitar un equipo de un dominio, debe moverlo a un grupo de trabajo. Use el parámetro WorkgroupName para especificar el grupo de trabajo.
Para mover un equipo de un grupo de trabajo a un dominio, de un grupo de trabajo a otro o de un dominio a otro, use el cmdlet Add-Computer.
Para obtener los resultados del comando, use el detallado de y parámetros de PassThru. Para suprimir el mensaje del usuario, use el parámetro Force.
Remove-Computer quita el equipo local y los equipos remotos de dominios. Incluye parámetros de credenciales que especifican credenciales alternativas para conectarse a equipos remotos y descomprimir desde un dominio, un parámetro Restart para reiniciar los equipos afectados y un parámetro WorkgroupName para especificar el nombre del grupo de trabajo al que se agregan los equipos.
Ejemplos
Ejemplo 1: Quitar el equipo local de su dominio
En este ejemplo se quita el equipo local del dominio al que está unido.
Remove-Computer -UnjoinDomaincredential Domain01\Admin01 -PassThru -Verbose -RestartEl parámetro UnjoinDomainCredential proporciona las credenciales de un administrador de dominio. El passThru y los parámetros comunes verbose muestran información sobre el éxito o el error del comando. El parámetro Restart Restart reinicia el equipo para completar la operación de eliminación.
Cuando no se especifica ningún nombre de grupo de trabajo, el equipo se mueve al grupo de trabajo denominado después de quitarlo de su dominio.
Ejemplo 2: Traslado de varios equipos a un grupo de trabajo heredado
En este ejemplo se quitan todos los equipos enumerados en el archivo OldServers.txt de sus dominios y se mueven al grupo de trabajo heredado.
Remove-Computer -ComputerName (Get-Content OldServers.txt) -LocalCredential Domain01\Admin01 -UnJoinDomainCredential Domain01\Admin01 -WorkgroupName "Legacy" -Force -RestartEl parámetro localCredential proporciona las credenciales de un usuario que tiene permiso para conectarse a equipos remotos. El parámetro UnjoinDomainCredential proporciona las credenciales de un usuario que tiene permiso para quitar los equipos de sus dominios. El parámetro Force suprime las solicitudes de confirmación de cada equipo. El parámetro Restart reinicia cada uno de los equipos después de quitarlo de su dominio.
Ejemplo 3: Quitar equipos de un grupo de trabajo sin confirmación
En este ejemplo se quita el equipo remoto, Server01 y el equipo local de sus dominios y se agregan al grupo de trabajo de Local.
Remove-Computer -ComputerName "Server01", "localhost" -UnjoinDomainCredential Domain01\Admin01 -WorkgroupName "Local" -Restart -ForceEl parámetro Force suprime la solicitud de confirmación de cada equipo. El parámetro Restart Restart reinicia los equipos para que el cambio sea efectivo.
Parámetros
-ComputerName
Especifica los equipos que se van a quitar de sus dominios. El valor predeterminado es el equipo local.
Escriba el nombre NetBIOS, una dirección IP o un nombre de dominio completo (FQDN) de los equipos remotos. Para especificar el equipo local, escriba el nombre del equipo, un punto (.) o localhost.
Este parámetro no se basa en la comunicación remota de PowerShell. Puede usar el parámetro ComputerName de Remove-Computer incluso si el equipo no está configurado para ejecutar comandos remotos.
Este parámetro se introdujo en PowerShell 3.0.
| Tipo: | String[] |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
-Confirm
Le pide confirmación antes de ejecutar el cmdlet.
| Tipo: | SwitchParameter |
| Alias: | cf |
| Posición: | Named |
| Valor predeterminado: | False |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-Force
Suprime el mensaje del usuario. De forma predeterminada, Remove-Computer le pedirá confirmación antes de quitar cada equipo.
| Tipo: | SwitchParameter |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-LocalCredential
Especifica una cuenta de usuario que tiene permiso para conectarse a los equipos que especifica el parámetro computerName . El valor predeterminado es el usuario actual.
Escriba un nombre de usuario, como User01 o Domain01\User01, o escriba un objeto de PSCredential de, como uno generado por el cmdlet Get-Credential. Si escribe un nombre de usuario, el cmdlet le pedirá una contraseña. Para especificar una cuenta de usuario que tenga permiso para quitar el equipo de su dominio actual, use el parámetro UnjoinDomainCredential.
Este parámetro se introdujo en PowerShell 3.0.
| Tipo: | PSCredential |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-PassThru
Devuelve los resultados del comando. De lo contrario, este cmdlet no genera ninguna salida.
| Tipo: | SwitchParameter |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-Restart
Indica que este cmdlet reinicia los equipos que se van a quitar. A menudo, se requiere un reinicio para hacer que el cambio sea efectivo.
Este parámetro se introdujo en PowerShell 3.0.
| Tipo: | SwitchParameter |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-UnjoinDomainCredential
Especifica una cuenta de usuario que tiene permiso para quitar los equipos de sus dominios actuales. Las credenciales explícitas, tal como se proporciona en este parámetro, son necesarias para quitar equipos remotos de un dominio, incluso cuando el valor es las credenciales del usuario actual.
Escriba un nombre de usuario, como User01 o Domain01\User01, o escriba un objeto de PSCredential, como uno generado por Get-Credential. Si escribe un nombre de usuario, este cmdlet le pedirá una contraseña.
Para especificar una cuenta de usuario que tenga permiso para conectarse a los equipos remotos, use el parámetro LocalCredential.
Este parámetro se introdujo en PowerShell 3.0.
| Tipo: | PSCredential |
| Alias: | Credential |
| Posición: | 0 |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-WhatIf
Muestra lo que sucedería si el cmdlet se ejecuta. El cmdlet no se ejecuta.
| Tipo: | SwitchParameter |
| Alias: | wi |
| Posición: | Named |
| Valor predeterminado: | False |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-WorkgroupName
Especifica el nombre de un grupo de trabajo al que se agregan los equipos cuando se quitan de sus dominios. El valor predeterminado es WORKGROUP. Al quitar un equipo de un dominio, debe agregarlo a un grupo de trabajo.
Este parámetro se introdujo en PowerShell 3.0.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
Entradas
Puede canalizar nombres de equipo a este cmdlet.
Salidas
Cuando se usa el parámetro PassThru, Remove-Computer devuelve un objeto ComputerChangeInfo.
De lo contrario, este cmdlet no genera ninguna salida.
Notas
Este cmdlet no quita equipos de grupos de trabajo.
