Remove-Computer

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>]

The Remove-Computer cmdlet removes the local computer and remote computers from their current domains.

When you remove a computer from a ___domain, Remove-Computer also disables the ___domain account of the computer. You must provide explicit credentials to unjoin the computer from its ___domain, even when they are the credentials of the current user. You must restart the computer to make the change effective. Also, when you remove a computer from a ___domain, you must move it to a workgroup. Use the WorkgroupName parameter to specify the workgroup.

To move a computer from a workgroup to a ___domain, from one workgroup to another, or from one ___domain to another, use the Add-Computer cmdlet.

To get the results of the command, use the Verbose and PassThru parameters. To suppress the user prompt, use the Force parameter.

Remove-Computer removes the local computer and remote computers from domains. It includes credential parameters that specify alternate credentials for connecting to remote computers, and unjoining from a ___domain, a Restart parameter for restarting the affected computers, and a WorkgroupName parameter for specifying the name of the workgroup to which computers are added.

This example removes the local computer from the ___domain to which it is joined.

Remove-Computer -UnjoinDomaincredential Domain01\Admin01 -PassThru -Verbose -Restart

The UnjoinDomainCredential parameter provides the credentials of a ___domain administrator. The PassThru and the Verbose common parameters display information about the success or failure of the command. The Restart parameter restarts the computer to complete the remove operation.

When no workgroup name is specified, the computer is moved to the workgroup named after it is removed from its ___domain.

This example removes all the computers listed in the OldServers.txt file from their domains and moves them into the Legacy workgroup.

Remove-Computer -ComputerName (Get-Content OldServers.txt) -LocalCredential Domain01\Admin01 -UnJoinDomainCredential Domain01\Admin01 -WorkgroupName "Legacy" -Force -Restart

The LocalCredential parameter provides the credentials of a user who has permission to connect to remote computers. The UnjoinDomainCredential parameter provides the credentials of a user who has permission to remove the computers from their domains. The Force parameter suppresses the confirmation prompts for each computer. The Restart parameter restarts each of the computers after it is removed from its ___domain.

This example removes the remote computer, Server01, and the local computer from their domains and adds them to the Local workgroup.

Remove-Computer -ComputerName "Server01", "localhost" -UnjoinDomainCredential Domain01\Admin01 -WorkgroupName "Local" -Restart -Force

The Force parameter suppresses the confirmation prompt for each computer. The Restart parameter restarts the computers to make the change effective.

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

You can pipe computer names to this cmdlet.

When you use the PassThru parameter, Remove-Computer returns a ComputerChangeInfo object. Otherwise, this cmdlet does not generate any output.

This cmdlet does not remove computers from workgroups.