Remove-Computer
Quita el equipo local de su dominio.
Sintaxis
Local (valor predeterminado)
Remove-Computer
[[-UnjoinDomainCredential] <PSCredential>]
[-Restart]
[-Force]
[-PassThru]
[-WorkgroupName <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remote
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
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 -Restart
El 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 -Restart
El 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 -Force
El 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 utiliza 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.
Propiedades de parámetro
| Tipo: | String[] |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
Remote
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | True |
| Valor de la canalización por nombre de propiedad: | True |
| Valor de los argumentos restantes: | False |
-Confirm
Le pide confirmación antes de ejecutar el cmdlet.
Propiedades de parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | False |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | cf |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Force
Suprime el mensaje del usuario. De forma predeterminada, Remove-Computer le pedirá confirmación antes de quitar cada equipo.
Propiedades de parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | 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 PSCredential , como uno generado por el Get-Credential cmdlet. 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.
Propiedades de parámetro
| Tipo: | PSCredential |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
Remote
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-PassThru
Devuelve los resultados del comando. De lo contrario, este cmdlet no genera ninguna salida.
Propiedades de parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | 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.
Propiedades de parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | 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 Usuario01 o Dominio01\Usuario01, o escriba un objeto 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.
Propiedades de parámetro
| Tipo: | PSCredential |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | Credencial |
Conjuntos de parámetros
Local
| Posición: | 0 |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
Remote
| Posición: | 0 |
| Obligatorio: | True |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-WhatIf
Muestra lo que sucedería si el cmdlet se ejecuta. El cmdlet no se ejecuta.
Propiedades de parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | False |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | Wi |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | 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.
Propiedades de parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
CommonParameters
Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.
Entradas
String
Puede canalizar nombres de equipos a este cmdlet.
Salidas
ComputerChangeInfo
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.