Delen via

Remove-Computer

  • Referentie
Module:
Microsoft.PowerShell.Management

Hiermee verwijdert u de lokale computer uit het domein.

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

De Remove-Computer cmdlet verwijdert de lokale computer en externe computers uit hun huidige domeinen.

Wanneer u een computer uit een domein verwijdert, Remove-Computer wordt ook het domeinaccount van de computer uitgeschakeld. U moet expliciete referenties opgeven om de computer los te maken van het domein, zelfs wanneer dit de referenties van de huidige gebruiker zijn. U moet de computer opnieuw opstarten om de wijziging effectief te maken. Wanneer u een computer uit een domein verwijdert, moet u deze ook verplaatsen naar een werkgroep. Gebruik de parameter WorkgroupName om de werkgroep op te geven.

Als u een computer wilt verplaatsen van een werkgroep naar een domein, van de ene werkgroep naar het andere, of van het ene domein naar het andere, gebruikt u de Add-Computer cmdlet.

Gebruik de parameters Uitgebreid en PassThru om de resultaten van de opdracht op te halen. Gebruik de parameter Force om de gebruikersprompt te onderdrukken.

Remove-Computer verwijdert de lokale computer en externe computers uit domeinen. Het bevat referentieparameters die alternatieve referenties opgeven voor het maken van verbinding met externe computers en het ontkoppelen van een domein, een parameter Opnieuw opstarten voor het opnieuw opstarten van de betrokken computers en een parameter WorkgroupName voor het opgeven van de naam van de werkgroep waaraan computers worden toegevoegd.

Voorbeelden

Voorbeeld 1: De lokale computer verwijderen uit het domein

In dit voorbeeld wordt de lokale computer verwijderd uit het domein waaraan de computer is toegevoegd.

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

De parameter UnjoinDomainCredential biedt de referenties van een domeinbeheerder. De PassThru en de uitgebreide algemene parameters geven informatie weer over het slagen of mislukken van de opdracht. De parameter Opnieuw opstarten start de computer opnieuw op om de verwijderbewerking te voltooien.

Wanneer er geen werkgroepnaam is opgegeven, wordt de computer verplaatst naar de werkgroep die hierna is verwijderd uit het domein.

Voorbeeld 2: Meerdere computers verplaatsen naar een verouderde werkgroep

In dit voorbeeld worden alle computers die in het bestand worden vermeld uit hun OldServers.txt domeinen verwijderd en verplaatst naar de verouderde werkgroep.

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

De parameter LocalCredential biedt de referenties van een gebruiker die gemachtigd is om verbinding te maken met externe computers. De parameter UnjoinDomainCredential biedt de referenties van een gebruiker die gemachtigd is om de computers uit hun domeinen te verwijderen. De parameter Force onderdrukt de bevestigingsprompts voor elke computer. De parameter Opnieuw opstarten start elk van de computers opnieuw op nadat deze uit het domein is verwijderd.

Voorbeeld 3: Computers uit een werkgroep verwijderen zonder bevestiging

In dit voorbeeld worden de externe computer, Server01 en de lokale computer uit hun domeinen verwijderd en toegevoegd aan de lokale werkgroep.

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

De parameter Force onderdrukt de bevestigingsprompt voor elke computer. De parameter Opnieuw opstarten start de computers opnieuw op om de wijziging effectief te maken.

Parameters

-ComputerName

Hiermee geeft u de computers die uit hun domeinen moeten worden verwijderd. Standaard is dit de lokale computer.

Typ de NetBIOS-naam, een IP-adres of een FQDN (Fully Qualified Domain Name) van de externe computers. Als u de lokale computer wilt opgeven, typt u de computernaam, een punt (.) of localhost.

Deze parameter is niet afhankelijk van externe communicatie van PowerShell. U kunt de computernaamparameter gebruiken, Remove-Computer zelfs als uw computer niet is geconfigureerd voor het uitvoeren van externe opdrachten.

Deze parameter is geïntroduceerd in PowerShell 3.0.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

Onderdrukt de gebruikersprompt. Remove-Computer Standaard wordt u gevraagd om bevestiging voordat u elke computer verwijdert.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-LocalCredential

Hiermee geeft u een gebruikersaccount op dat gemachtigd is om verbinding te maken met de computers die de parameter ComputerName opgeeft. Standaard is dit de huidige gebruiker.

Typ een gebruikersnaam, zoals User01 of Domain01\User01, of voer een PSCredential-object in, zoals een object dat is gegenereerd door de Get-Credential cmdlet. Als u een gebruikersnaam typt, wordt u door de cmdlet gevraagd om een wachtwoord. Als u een gebruikersaccount wilt opgeven dat gemachtigd is om de computer uit het huidige domein te verwijderen, gebruikt u de parameter UnjoinDomainCredential .

Deze parameter is geïntroduceerd in PowerShell 3.0.

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PassThru

Retourneert de resultaten van de opdracht. Anders genereert deze cmdlet geen uitvoer.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Restart

Geeft aan dat deze cmdlet de computers die worden verwijderd opnieuw opstart. Een herstart is vaak vereist om de wijziging effectief te maken.

Deze parameter is geïntroduceerd in PowerShell 3.0.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UnjoinDomainCredential

Hiermee geeft u een gebruikersaccount op dat gemachtigd is om de computers uit hun huidige domeinen te verwijderen. Expliciete referenties, zoals opgegeven door deze parameter, zijn vereist om externe computers uit een domein te verwijderen, zelfs wanneer de waarde de referenties van de huidige gebruiker is.

Typ een gebruikersnaam, zoals User01 of Domain01\User01, of voer een PSCredential-object in, zoals een object dat is gegenereerd door Get-Credential. Als u een gebruikersnaam typt, wordt u door deze cmdlet gevraagd om een wachtwoord.

Als u een gebruikersaccount wilt opgeven dat gemachtigd is om verbinding te maken met de externe computers, gebruikt u de parameter LocalCredential .

Deze parameter is geïntroduceerd in PowerShell 3.0.

Type:PSCredential
Aliases:Credential
Position:0
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WorkgroupName

Hiermee geeft u de naam op van een werkgroep waaraan de computers worden toegevoegd wanneer ze uit hun domeinen worden verwijderd. De standaardwaarde is WORKGROUP. Wanneer u een computer uit een domein verwijdert, moet u deze toevoegen aan een werkgroep.

Deze parameter is geïntroduceerd in PowerShell 3.0.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Invoerwaarden

String

U kunt computernamen doorsluisen naar deze cmdlet.

Uitvoerwaarden

ComputerChangeInfo

Wanneer u de parameter PassThru gebruikt, Remove-Computer wordt een ComputerChangeInfo-object geretourneerd. Anders genereert deze cmdlet geen uitvoer.

Notities

Met deze cmdlet worden computers niet uit werkgroepen verwijderd.