Remove-Computer

  • Referencia
Módulo:
Microsoft.PowerShell.Management

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 desenlazar 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. 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 Add-Computer cmdlet .

Para obtener los resultados del comando, use los parámetros Verbose y PassThru . Para suprimir el mensaje del usuario, use el parámetro Force .

Remove-Computer quita el equipo local y los equipos remotos de los 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. 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 -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 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 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 aunque 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, use 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 van a quitar. 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 que tenga permiso para conectarse a los equipos remotos, use 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

String

Puede canalizar nombres de equipo 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 resultados.

Notas

Este cmdlet no elimina equipos de grupos de trabajo.