Remove-Computer
Quita el equipo local de su dominio.
Syntax
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 Remove-Computer cmdlet 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 desasociar el equipo desde su dominio, incluso cuando son las credenciales del usuario actual. Debe reiniciar el equipo para que el cambio sea efectivo. Asimismo, cuando se quita un equipo de un dominio, este debe moverse a un grupo de trabajo. Utilice 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 Add-Computer cmdlet .
Para obtener los resultados del comando, utilice los parámetros Verbose y PassThru. Para suprimir el mensaje de usuario, utilice el parámetro Force.
Remove-Computer quita el equipo local y los equipos remotos de los dominios. Incluye los parámetros de credenciales que especifican credenciales alternativas para conectarse a equipos remotos, así como para separarse de 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. Los parámetros PassThru y Verbose common muestran información sobre el éxito o error del comando. El parámetro 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 OldServers.txt archivo 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 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 reinicia los equipos para que el cambio sea efectivo.
Parámetros
-ComputerName
Especifica los equipos que se quitan de sus dominios. La opción predeterminada 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.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Confirm
Le solicita su confirmación antes de ejecutar el cmdlet.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Force
Suprime el mensaje de usuario. De forma predeterminada, Remove-Computer le pide confirmación antes de quitar cada equipo.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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, utilice el parámetro UnjoinDomainCredential.
Este parámetro se introdujo en PowerShell 3.0.
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PassThru
Devuelve los resultados del comando. De lo contrario, este cmdlet no genera resultados.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Restart
Indica que este cmdlet reinicia los equipos que se están quitando. A menudo es necesario reiniciar para que el cambio surta efecto.
Este parámetro se introdujo en PowerShell 3.0.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UnjoinDomainCredential
Especifica una cuenta de usuario con permiso para quitar los equipos de sus dominios actuales. Es obligatorio proporcionar credenciales explícitas, según lo proporcionado por este parámetro, para quitar equipos remotos de un dominio, aunque el valor sea el de las credenciales del usuario actual.
Escriba un nombre de usuario, como User01 o Domain01\User01, 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 con permiso para conectarse a los equipos remotos, utilice el parámetro LocalCredential.
Este parámetro se introdujo en PowerShell 3.0.
| Type: | PSCredential |
| Aliases: | Credential |
| Position: | 0 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WorkgroupName
Especifica el nombre de un grupo de trabajo al que se agregan los equipos cuando se eliminan de sus dominios. El valor predeterminado es WORKGROUP. Cuando quite un equipo de un dominio, debe agregarlo a un grupo de trabajo.
Este parámetro se introdujo en PowerShell 3.0.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Entradas
Puede canalizar nombres de equipo a estecmdlet.
Salidas
Cuando se usa el parámetro PassThru , Remove-Computer devuelve un objeto ComputerChangeInfo .
De lo contrario, este cmdlet no genera resultados.
Notas
Este cmdlet no elimina equipos de grupos de trabajo.