Remove-Computer

Entfernt den lokalen Computer aus einer Arbeitsgruppe oder einer Domäne.

Syntax

Remove-Computer [[-Credential] <PSCredential>] [-Force] [-PassThru] [-Confirm] [-WhatIf] [<CommonParameters>]

Beschreibung

Das Cmdlet "Remove-Computer" entfernt den lokalen Computer aus seiner aktuellen Arbeitsgruppe oder Domäne.

Wenn Sie einen Computer aus einer Domäne entfernen, deaktiviert Remove-Computer auch das Domänenkonto des Computers.

Wenn sich der Computer in einer Domäne befindet, müssen Sie Anmeldeinformationen bereitstellen, selbst wenn es sich um die Anmeldeinformationen des aktuellen Benutzers handelt. Außerdem müssen Sie den Computer neu starten, damit die Änderung wirksam wird.

Mit dem Verbose-Parameter und dem PassThru-Parameter können Sie die Ergebnisse des Befehls abrufen.

Parameter

-Credential <PSCredential>

Gibt ein Benutzerkonto an, das über die Berechtigung zum Ausführen dieser Aktion verfügt. Der Standardwert ist der aktuelle Benutzer.

Geben Sie einen Benutzernamen ein, z. B. "User01" oder "Domain01\User01", oder geben Sie ein PSCredential-Objekt ein, z. B. ein vom Cmdlet "Get-Credential" generiertes Objekt. Wenn Sie einen Benutzernamen eingeben, werden Sie zur Eingabe eines Kennworts aufgefordert.

Zum Entfernen eines Computers aus einer Domäne müssen Sie den Credential-Parameter verwenden, selbst wenn Sie die Anmeldeinformationen des aktuellen Benutzers verwenden.

Erforderlich?	false
Position?	2
Standardwert	Die Anmeldeinformationen des aktuellen Benutzers
Pipelineeingaben akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

-Force

Erforderlich?	false
Position?	named
Standardwert
Pipelineeingaben akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

-PassThru

Gibt die Ergebnisse des Befehls zurück. Andernfalls wird von diesem Cmdlet keine Ausgabe generiert.

Erforderlich?	false
Position?	named
Standardwert
Pipelineeingaben akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

-Confirm

Fordert Sie vor der Ausführung des Befehls zur Bestätigung auf.

Erforderlich?	false
Position?	named
Standardwert
Pipelineeingaben akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

-WhatIf

Beschreibt die Auswirkungen einer Ausführung des Befehls, ohne den Befehl tatsächlich auszuführen.

Erforderlich?	false
Position?	named
Standardwert
Pipelineeingaben akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

<CommonParameters>

Dieses Cmdlet unterstützt die folgenden allgemeinen Parameter: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer und -OutVariable. Weitere Informationen finden Sie unter about_Commonparameters.

Eingaben und Ausgaben

Der Eingabetyp ist der Typ der Objekte, die über die Pipeline an das Cmdlet übergeben werden können. Der Rückgabetyp ist der Typ der Objekte, die das Cmdlet zurückgibt.

Eingaben	Keiner Eingaben können nicht über die Pipeline an dieses Cmdlet übergeben werden.
Ausgaben	Microsoft.PowerShell.Commands.ComputerChangeInfo Wenn Sie den PassThru-Parameter verwenden, wird von Remove-Computer ein ComputerChangeInfo-Objekt zurückgegeben. Andernfalls wird von diesem Cmdlet keine Ausgabe generiert.

Beispiel 1

C:\PS>remove-computer

Beschreibung
-----------
Dieser Befehl entfernt den Computer aus einer Arbeitsgruppe.

Beispiel 2

C:\PS>remove-computer -credential domain01\admin01 -passthru -verbose; restart-computer

Beschreibung
-----------
Mit diesen Befehlen wird der lokale Computer aus der Domäne entfernt, der er angehört.

Mit dem ersten Befehl wird der Computer aus der Domäne entfernt. In diesem Befehl werden die Anmeldeinformationen eines Domänenadministrators mit dem Credential-Parameter angegeben. Mit dem PassThru-Parameter und dem allgemeinen Verbose-Parameter werden Informationen darüber angezeigt, ob der Befehl erfolgreich ausgeführt wurde oder nicht.

Im zweiten Befehl wird der Computer mit dem Cmdlet "Restart-Computer" neu gestartet, was erforderlich ist, um den Vorgang zum Entfernen abzuschließen.

Die beiden Befehle werden durch ein Semikolon (;) getrennt.

Siehe auch

Konzepte

Add-Computer
Checkpoint-Computer
Remove-Computer
Restart-Computer
Restore-Computer
Stop-Computer
Test-Connection