Remove-Computer
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 koppelen van het domein, zelfs als ze de referenties van de huidige gebruiker zijn. U moet de computer opnieuw opstarten om de wijziging van kracht te laten worden. 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 de andere of van het ene domein naar het andere, gebruikt u de Add-Computer
cmdlet.
Gebruik de parameters Verbose en PassThru om de resultaten van de opdracht op te halen. Als u de gebruikersprompt wilt onderdrukken, gebruikt u de parameter Force .
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 Werkgroepnaam voor het opgeven van de naam van de werkgroep waaraan computers worden toegevoegd.
Voorbeelden
Voorbeeld 1: De lokale computer uit het domein verwijderen
In dit voorbeeld wordt de lokale computer verwijderd uit het domein waaraan deze is gekoppeld.
Remove-Computer -UnjoinDomaincredential Domain01\Admin01 -PassThru -Verbose -Restart
De parameter UnjoinDomainCredential biedt de referenties van een domeinbeheerder. De algemene parameters PassThru en Uitgebreid geven informatie weer over het slagen of mislukken van de opdracht. Met de parameter Restart wordt de computer opnieuw opgestart om de verwijderbewerking te voltooien.
Wanneer er geen werkgroepnaam is opgegeven, wordt de computer verplaatst naar de werkgroep met de naam nadat deze uit het domein is verwijderd.
Voorbeeld 2: Meerdere computers verplaatsen naar een verouderde werkgroep
In dit voorbeeld worden alle computers die in het OldServers.txt
bestand worden vermeld uit hun 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 LocalCredential parameter 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. Met de parameter Restart worden alle computers opnieuw opgestart nadat deze uit het domein zijn 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. Met de parameter Restart worden de computers opnieuw opgestart om de wijziging van kracht te laten worden.
Parameters
-ComputerName
Hiermee geeft u de computers worden verwijderd uit hun domeinen. 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 parameter ComputerName van Remove-Computer
zelfs gebruiken 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. Standaard wordt Remove-Computer
u om bevestiging gevraagd 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 is gemachtigd om verbinding te maken met de computers die de computernaam parameter 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 wordt gegenereerd door de Get-Credential
cmdlet. Als u een gebruikersnaam typt, wordt u 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 met deze cmdlet de computers die worden verwijderd, opnieuw worden opgestart. Een herstart is vaak vereist om de wijziging van kracht te laten worden.
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 wordt gegenereerd door Get-Credential
. Als u een gebruikersnaam typt, wordt u met deze cmdlet gevraagd om een wachtwoord.
Als u een gebruikersaccount wilt opgeven dat is gemachtigd 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 van een werkgroep waaraan de computers worden toegevoegd wanneer ze worden verwijderd uit hun domeinen. 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
U kunt computernamen doorsnijden naar dezecmdlet.
Uitvoerwaarden
Wanneer u de parameter PassThru gebruikt, Remove-Computer
retourneert het object ComputerChangeInfo .
Anders genereert deze cmdlet geen uitvoer.
Notities
Deze cmdlet verwijdert geen computers uit werkgroepen.