Remove-Computer
Entfernt den lokalen Computer aus seiner Domäne.
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>]Beschreibung
Mit dem Cmdlet Remove-Computer werden der lokale Computer und Remotecomputer aus ihren aktuellen Domänen entfernt.
Wenn Sie einen Computer aus einer Domäne entfernen, deaktiviert Remove-Computer auch das Domänenkonto des Computers. Sie müssen explizite Anmeldeinformationen angeben, um die Verknüpfung des Computers von seiner Domäne aufzuheben, auch wenn sie die Anmeldeinformationen des aktuellen Benutzers sind. Sie müssen den Computer neu starten, um die Änderung wirksam zu machen. Wenn Sie einen Computer aus einer Domäne entfernen, müssen Sie ihn auch in eine Arbeitsgruppe verschieben. Verwenden Sie den WorkgroupName Parameter, um die Arbeitsgruppe anzugeben.
Um einen Computer aus einer Arbeitsgruppe in eine Domäne zu verschieben, verwenden Sie das Cmdlet Add-Computer von einer Arbeitsgruppe in eine andere oder von einer Domäne in eine andere.
Verwenden Sie zum Abrufen der Ergebnisse des Befehls die Parameter Verbose und PassThru. Um die Benutzeraufforderung zu unterdrücken, verwenden Sie den Parameter Force.
Remove-Computer entfernt den lokalen Computer und Remotecomputer aus Domänen. Es enthält Anmeldeinformationsparameter, die alternative Anmeldeinformationen für die Verbindung mit Remotecomputern angeben und die Verknüpfung von einer Domäne aufheben, einen parameter Restart zum Neustart der betroffenen Computer sowie einen WorkgroupName Parameter zum Angeben des Namens der Arbeitsgruppe, der Computer hinzugefügt werden.
Beispiele
Beispiel 1: Entfernen des lokalen Computers aus seiner Domäne
In diesem Beispiel wird der lokale Computer aus der Domäne entfernt, in die er eingebunden ist.
Remove-Computer -UnjoinDomaincredential Domain01\Admin01 -PassThru -Verbose -RestartDer Parameter UnjoinDomainCredential stellt die Anmeldeinformationen eines Domänenadministrators bereit. Die PassThru- und die Ausführliche allgemeine Parameter zeigen Informationen zum Erfolg oder Fehler des Befehls an. Der Parameter "Neustarten" startet den Computer neu, um den Vorgang zum Entfernen abzuschließen.
Wenn kein Arbeitsgruppenname angegeben ist, wird der Computer in die Arbeitsgruppe verschoben, die nach dem Entfernen aus der Domäne benannt wurde.
Beispiel 2: Verschieben mehrerer Computer in eine ältere Arbeitsgruppe
In diesem Beispiel werden alle computer, die in der OldServers.txt-Datei aufgeführt sind, aus ihren Domänen entfernt und in die Arbeitsgruppe Legacy verschoben.
Remove-Computer -ComputerName (Get-Content OldServers.txt) -LocalCredential Domain01\Admin01 -UnJoinDomainCredential Domain01\Admin01 -WorkgroupName "Legacy" -Force -RestartDer Parameter LocalCredential stellt die Anmeldeinformationen eines Benutzers bereit, der über die Berechtigung zum Herstellen einer Verbindung mit Remotecomputern verfügt. Der Parameter UnjoinDomainCredential stellt die Anmeldeinformationen eines Benutzers bereit, der über die Berechtigung zum Entfernen der Computer aus seinen Domänen verfügt. Der Parameter Force unterdrückt die Bestätigungsaufforderungen für jeden Computer. Der Parameter "Neustarten" startet jeden computer neu, nachdem er aus seiner Domäne entfernt wurde.
Beispiel 3: Entfernen von Computern aus einer Arbeitsgruppe ohne Bestätigung
In diesem Beispiel werden der Remotecomputer, server01 und der lokale Computer aus ihren Domänen entfernt und der Lokalen Arbeitsgruppe hinzugefügt.
Remove-Computer -ComputerName "Server01", "localhost" -UnjoinDomainCredential Domain01\Admin01 -WorkgroupName "Local" -Restart -ForceDer parameter Force unterdrückt die Bestätigungsaufforderung für jeden Computer. Der Parameter "Restart" startet die Computer neu, um die Änderung wirksam zu machen.
Parameter
-ComputerName
Gibt die Computer an, die aus ihren Domänen entfernt werden sollen. Der Standardwert ist der lokale Computer.
Geben Sie den NetBIOS-Namen, eine IP-Adresse oder einen vollqualifizierten Domänennamen (Fully Qualified Domain Name, FQDN) der Remotecomputer ein. Um den lokalen Computer anzugeben, geben Sie den Computernamen, einen Punkt (.) oder localhostein.
Dieser Parameter basiert nicht auf PowerShell-Remoting. Sie können den ComputerName Parameter von Remove-Computer verwenden, auch wenn Ihr Computer nicht für die Ausführung von Remotebefehlen konfiguriert ist.
Dieser Parameter wurde in PowerShell 3.0 eingeführt.
| Typ: | String[] |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-Confirm
Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.
| Typ: | SwitchParameter |
| Aliase: | cf |
| Position: | Named |
| Standardwert: | False |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Force
Unterdrückt die Benutzeraufforderung. Standardmäßig fordert Remove-Computer Sie vor dem Entfernen der einzelnen Computer zur Bestätigung auf.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-LocalCredential
Gibt ein Benutzerkonto an, das über die Berechtigung zum Herstellen einer Verbindung mit den Computern verfügt, die der parameter ComputerName angibt. Die Standardeinstellung ist der aktuelle Benutzer.
Geben Sie einen Benutzernamen ein, z. B. User01 oder Domain01\User01, oder geben Sie ein PSCredential--Objekt ein, z. B. einen, der vom Cmdlet Get-Credential generiert wird. Wenn Sie einen Benutzernamen eingeben, werden Sie vom Cmdlet aufgefordert, ein Kennwort einzugeben. Um ein Benutzerkonto anzugeben, das über die Berechtigung zum Entfernen des Computers aus seiner aktuellen Domäne verfügt, verwenden Sie den Parameter UnjoinDomainCredential.
Dieser Parameter wurde in PowerShell 3.0 eingeführt.
| Typ: | PSCredential |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-PassThru
Gibt die Ergebnisse des Befehls zurück. Andernfalls generiert dieses Cmdlet keine Ausgabe.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Restart
Gibt an, dass dieses Cmdlet die Computer neu startet, die entfernt werden. Ein Neustart ist häufig erforderlich, um die Änderung wirksam zu machen.
Dieser Parameter wurde in PowerShell 3.0 eingeführt.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-UnjoinDomainCredential
Gibt ein Benutzerkonto an, das über die Berechtigung zum Entfernen der Computer aus ihren aktuellen Domänen verfügt. Explizite Anmeldeinformationen, wie dieser Parameter angegeben, müssen Remotecomputer aus einer Domäne entfernen, auch wenn der Wert die Anmeldeinformationen des aktuellen Benutzers ist.
Geben Sie einen Benutzernamen ein, z. B. User01 oder Domain01\User01, oder geben Sie ein PSCredential--Objekt ein, z. B. einen, der von Get-Credentialgeneriert wird. Wenn Sie einen Benutzernamen eingeben, werden Sie von diesem Cmdlet aufgefordert, ein Kennwort einzugeben.
Um ein Benutzerkonto anzugeben, das über die Berechtigung zum Herstellen einer Verbindung mit den Remotecomputern verfügt, verwenden Sie den Parameter LocalCredential.
Dieser Parameter wurde in PowerShell 3.0 eingeführt.
| Typ: | PSCredential |
| Aliase: | Credential |
| Position: | 0 |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-WhatIf
Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
| Typ: | SwitchParameter |
| Aliase: | wi |
| Position: | Named |
| Standardwert: | False |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-WorkgroupName
Gibt den Namen einer Arbeitsgruppe an, zu der die Computer hinzugefügt werden, wenn sie aus ihren Domänen entfernt werden. Der Standardwert ist WORKGROUP. Wenn Sie einen Computer aus einer Domäne entfernen, müssen Sie ihn einer Arbeitsgruppe hinzufügen.
Dieser Parameter wurde in PowerShell 3.0 eingeführt.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
Eingaben
Sie können Computernamen an dieses Cmdlet weiterleiten.
Ausgaben
Wenn Sie den PassThru--Parameter verwenden, gibt Remove-Computer ein ComputerChangeInfo--Objekt zurück.
Andernfalls generiert dieses Cmdlet keine Ausgabe.
Hinweise
Dieses Cmdlet entfernt keine Computer aus Arbeitsgruppen.
