Remove-Computer
Hiermee verwijdert u de lokale computer uit het domein.
Syntax
Local (Standaard)
Remove-Computer
[[-UnjoinDomainCredential] <PSCredential>]
[-Restart]
[-Force]
[-PassThru]
[-WorkgroupName <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remote
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, schakelt Remove-Computer ook het domeinaccount van de computer uit. 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 naar het andere domein, gebruikt u de cmdlet Add-Computer.
Als u de resultaten van de opdracht wilt ophalen, gebruikt u de parameters Uitgebreide en PassThru. 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 betreffende computers en een Werkgroepnaam parameter 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 in het OldServers.txt-bestand uit hun domeinen verwijderd en verplaatst deze 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 Forceren onderdrukt de bevestigingsprompts voor elke computer. Met de parameter Opnieuw opstarten worden alle computers opnieuw opgestart 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 Forceren onderdrukt de bevestigingsprompt voor elke computer. Met de parameter Opnieuw opstarten worden de computers opnieuw opgestart om de wijziging effectief te maken.
Parameters
-ComputerName
Hiermee geeft u de computers die uit hun domeinen moeten worden verwijderd. De standaardwaarde is 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 PowerShell-remoteverbindingen. U kunt de parameter ComputerName van Remove-Computer gebruiken, zelfs als uw computer niet is geconfigureerd voor het uitvoeren van externe opdrachten.
Deze parameter is geïntroduceerd in PowerShell 3.0.
Parametereigenschappen
| Type: | String[] |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
Remote
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | True |
| Waarde uit pijplijn op eigenschapsnaam: | True |
| Waarde van resterende argumenten: | False |
-Confirm
Voordat u de cmdlet uitvoert, vraagt het systeem om bevestiging.
Parametereigenschappen
| Type: | SwitchParameter |
| Default value: | False |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
| Aliassen: | Cf |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-Force
Onderdrukt de gebruikersprompt. Standaard wordt Remove-Computer u om bevestiging gevraagd voordat u elke computer verwijdert.
Parametereigenschappen
| Type: | SwitchParameter |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-LocalCredential
Hiermee geeft u een gebruikersaccount op dat gemachtigd is om verbinding te maken met de computers die de ComputerName parameter specificeert. De standaardwaarde is 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.
Parametereigenschappen
| Type: | PSCredential |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
Remote
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-PassThru
Retourneert de resultaten van de opdracht. Anders genereert deze cmdlet geen uitvoer.
Parametereigenschappen
| Type: | SwitchParameter |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | 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.
Parametereigenschappen
| Type: | SwitchParameter |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | 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.
Parametereigenschappen
| Type: | PSCredential |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
| Aliassen: | Bevoegdheidsbewijs |
Parametersets
Local
| Position: | 0 |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
Remote
| Position: | 0 |
| Verplicht: | True |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-WhatIf
Toont wat er zou gebeuren wanneer de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.
Parametereigenschappen
| Type: | SwitchParameter |
| Default value: | False |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
| Aliassen: | Wi |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | 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 WERKGROEP-. Wanneer u een computer uit een domein verwijdert, moet u deze toevoegen aan een werkgroep.
Deze parameter is geïntroduceerd in PowerShell 3.0.
Parametereigenschappen
| Type: | String |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
CommonParameters
Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.
Invoerwaarden
String
U kunt computernamen doorsluisen naar deze cmdlet.
Uitvoerwaarden
ComputerChangeInfo
Wanneer u de parameter PassThru gebruikt, retourneert Remove-Computer een ComputerChangeInfo--object.
Anders genereert deze cmdlet geen uitvoer.
Notities
Met deze cmdlet worden computers niet uit werkgroepen verwijderd.
