Entfernt den lokalen Computer aus einer Arbeitsgruppe oder einer Domäne.
Syntax
Remove-Computer [[-Credential] <PSCredential>] [-Force] [-PassThru] [-Bestätigung] [-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 |
The credentials of the current user |
|
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 |
-Bestätigung
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 |
None 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