Remove-Computer

  • Referenz
Modul:
Microsoft.PowerShell.Management

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 Remove-Computer Cmdlet werden der lokale Computer und die Remotecomputer aus ihren aktuellen Aufgaben entfernt Standard.

Wenn Sie einen Computer aus einer Do Standard entfernen, Remove-Computer wird auch das Do Standard Konto des Computers deaktiviert. Sie müssen explizite Anmeldeinformationen angeben, um die Verknüpfung des Computers von seiner Aufgaben zu aufheben Standard, auch wenn sie die Anmeldeinformationen des aktuellen Benutzers sind. Sie müssen den Computer neu starten, um die Änderung wirksam zu machen. Darüber hinaus muss ein Computer, wenn er aus einer Domäne entfernt wird, in eine Arbeitsgruppe verschoben werden. Verwenden Sie den Parameter "WorkgroupName ", um die Arbeitsgruppe anzugeben.

Verwenden Sie das Add-Computer Cmdlet, um einen Computer aus einer Arbeitsgruppe in eine Aufgabengruppe zu verschieben Standard von einer Arbeitsgruppe in eine andere oder von einer Gruppe Standard in eine andere.

Verwenden Sie die Parameter "Verbose " und "PassThru ", um die Ergebnisse des Befehls abzurufen. Verwenden Sie den Parameter Force , um die Benutzeraufforderung zu unterdrücken.

Remove-Computerentfernt den lokalen Computer und Remotecomputer von do Standard s. Sie enthält Anmeldeinformationsparameter, die alternative Anmeldeinformationen für die Verbindung mit Remotecomputern angeben und die Verknüpfung von einer Do Standard aufheben, einen Restart-Parameter für den Neustart der betroffenen Computer und einen WorkgroupName-Parameter zum Angeben des Namens der Arbeitsgruppe, der Computer hinzugefügt werden.

Beispiele

Beispiel 1: Entfernen sie den lokalen Computer aus seiner Aufgaben Standard

In diesem Beispiel wird der lokale Computer aus der Do Standard entfernt, mit dem er verbunden ist.

Remove-Computer -UnjoinDomaincredential Domain01\Admin01 -PassThru -Verbose -Restart

Der Parameter "UnjoinDo Standard Credential" stellt die Anmeldeinformationen eines Do Standard Administrators bereit. PassThru und die ausführlichen allgemeinen Parameter zeigen Informationen zum Erfolg oder Fehler des Befehls an. Der Parameter "Restart " startet den Computer neu, um den Vorgang zum Entfernen abzuschließen.

Wenn kein Arbeitsgruppenname angegeben wird, wird der Computer in die Arbeitsgruppe verschoben, die nach dem Entfernen aus seiner Aufgabengruppe benannt wurde Standard.

Beispiel 2: Verschieben mehrerer Computer in eine ältere Arbeitsgruppe

In diesem Beispiel werden alle computer, die in der OldServers.txt Datei aufgeführt sind Standard entfernt und in die Arbeitsgruppe "Legacy" verschoben.

Remove-Computer -ComputerName (Get-Content OldServers.txt) -LocalCredential Domain01\Admin01 -UnJoinDomainCredential Domain01\Admin01 -WorkgroupName "Legacy" -Force -Restart

Der Parameter "LocalCredential " stellt die Anmeldeinformationen eines Benutzers bereit, der über die Berechtigung zum Herstellen einer Verbindung mit Remotecomputern verfügt. Der Parameter "UnjoinDo Standard Credential" stellt die Anmeldeinformationen eines Benutzers bereit, der über die Berechtigung zum Entfernen der Computer aus ihrer Aufgabe verfügt Standard s. Der Parameter Force unterdrückt die Bestätigungsaufforderungen für jeden Computer. Der Parameter "Restart" startet jeden der Computer neu, nachdem er aus seiner Do entfernt wurde Standard.

Beispiel 3: Entfernen von Computern aus einer Arbeitsgruppe ohne Bestätigung

In diesem Beispiel werden der Remotecomputer, Server01 und der lokale Computer aus ihren Aufgaben entfernt Standard und fügt sie der lokalen Arbeitsgruppe hinzu.

Remove-Computer -ComputerName "Server01", "localhost" -UnjoinDomainCredential Domain01\Admin01 -WorkgroupName "Local" -Restart -Force

Der 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. Die Standardeinstellung ist der lokale Computer.

Geben Sie den NetBIOS-Namen, eine IP-Adresse oder einen vollqualifizierten Do Standard Namen (FQDN) der Remotecomputer ein. Um den lokalen Computer anzugeben, geben Sie den Computernamen, einen Punkt (.) oder localhosteinen .

Dieser Parameter basiert nicht auf PowerShell-Remoting. Sie können den Parameter Remove-Computer "ComputerName" auch dann verwenden, wenn Ihr Computer nicht für die Ausführung von Remotebefehlen konfiguriert ist.

Dieser Parameter wurde in PowerShell 3.0 eingeführt.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

Unterdrückt die Benutzeraufforderung. Fordert Sie standardmäßig zur Bestätigung auf, Remove-Computer bevor Sie jeden Computer entfernen.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-LocalCredential

Gibt ein Benutzerkonto an, das über die Berechtigung zum Herstellen einer Verbindung mit den Computern verfügt, die der Parameter ComputerName angibt. Der Standardwert ist der aktuelle Benutzer.

Geben Sie einen Benutzernamen ein, zUser01. B. oder Domain01\User01geben Sie ein PSCredential-Objekt ein, z. B. einen vom Get-Credential Cmdlet generierten. Wenn Sie einen Benutzernamen eingeben, werden Sie vom Cmdlet aufgefordert, ein Kennwort einzugeben. Verwenden Sie den Parameter "UnjoinDo Standard Credential Standard, um ein Benutzerkonto anzugeben, das über die Berechtigung zum Entfernen des Computers verfügt Standard.

Dieser Parameter wurde in PowerShell 3.0 eingeführt.

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PassThru

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Restart

Gibt an, dass dieses Cmdlet die Computer neu startet, die entfernt werden. Ein Neustart ist häufig erforderlich, damit die Änderung wirksam wird.

Dieser Parameter wurde in PowerShell 3.0 eingeführt.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UnjoinDomainCredential

Gibt ein Benutzerkonto an, das über die Berechtigung zum Entfernen der Computer aus ihren aktuellen Domänen verfügt. Explizite Anmeldeinformationen, wie sie von diesem Parameter bereitgestellt werden, sind erforderlich, um Remotecomputer aus einer Domäne zu entfernen, auch wenn der Wert die Anmeldeinformationen des aktuellen Benutzers darstellt.

Geben Sie einen Benutzernamen ein, zUser01. B. oder Domain01\User01geben Sie ein PSCredential-Objekt ein, z. B. einen von Get-Credential. Wenn Sie einen Benutzernamen eingeben, werden Sie von diesem Cmdlet aufgefordert, ein Kennwort einzugeben.

Verwenden Sie den Parameter "LocalCredential ", um ein Benutzerkonto anzugeben, das über die Berechtigung zum Herstellen einer Verbindung mit den Remotecomputern verfügt.

Dieser Parameter wurde in PowerShell 3.0 eingeführt.

Type:PSCredential
Aliases:Credential
Position:0
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WorkgroupName

Gibt den Namen einer Arbeitsgruppe an, der die Computer nach dem Entfernen aus den Domänen hinzugefügt werden. Der Standardwert ist WORKGROUP. Wenn ein Computer aus einer Domäne entfernt wird, muss er einer Arbeitsgruppe hinzugefügt werden.

Dieser Parameter wurde in PowerShell 3.0 eingeführt.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Eingaben

String

Sie können Computernamen an dieses Cmdlet weiterleiten.

Ausgaben

ComputerChangeInfo

Wenn Sie den PassThru-Parameter verwenden, Remove-Computer wird ein ComputerChangeInfo-Objekt zurückgegeben. Andernfalls wird von diesem Cmdlet keine Ausgabe generiert.

Hinweise

Mit diesem Cmdlet werden keine Computer aus Arbeitsgruppen entfernt.