Freigeben über


Rename-Computer

Benennt einen Computer um.

Syntax

Rename-Computer
      [-ComputerName <String>]
      [-PassThru]
      [-DomainCredential <PSCredential>]
      [-LocalCredential <PSCredential>]
      [-NewName] <String>
      [-Force]
      [-Restart]
      [-WsmanAuthentication <String>]
      [-Protocol <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Beschreibung

Das Rename-Computer Cmdlet benennt den lokalen Computer oder einen Remotecomputer um. Es benennt einen Computer in jedem Befehl um.

Dieses Cmdlet wurde in Windows PowerShell 3.0 eingeführt.

Beispiele

Beispiel 1: Umbenennen des lokalen Computers

Mit diesem Befehl wird der lokale Computer Server044 umbenannt und anschließend neu gestartet, um die Änderung wirksam zu machen.

Rename-Computer -NewName "Server044" -DomainCredential Domain01\Admin01 -Restart

Beispiel 2: Umbenennen eines Remotecomputers

Mit diesem Befehl wird der Srv01 Computer in Server001. Der Computer wird nicht neu gestartet.

Der Parameter "DomainCredential " gibt die Anmeldeinformationen eines Benutzers an, der über die Berechtigung zum Umbenennen von Computern in der Domäne verfügt.

Der Parameter Force unterdrückt die Bestätigungsaufforderung.

Rename-Computer -ComputerName "Srv01" -NewName "Server001" -DomainCredential Domain01\Admin01 -Force

Parameter

-ComputerName

Benennt den angegebenen Remotecomputer um. Die Standardeinstellung ist der lokale Computer.

Geben Sie den NetBIOS-Namen, eine IP-Adresse oder den vollqualifizierten Domänennamen eines Remotecomputers 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 Rename-Computer "ComputerName" auch dann verwenden, wenn Ihr Computer nicht für die Ausführung von Remotebefehlen konfiguriert ist.

Typ:String
Position:Named
Standardwert:Local Computer
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Confirm

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

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DomainCredential

Gibt ein Benutzerkonto an, das über die Berechtigung zum Herstellen einer Verbindung mit der Domäne verfügt. Zum Umbenennen eines der Domäne hinzugefügten Computers sind explizite Anmeldeinformationen erforderlich.

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 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 dem Computer verfügt, der durch den Parameter ComputerName angegeben wird.

Typ:PSCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Force

Erzwingt die Ausführung des Befehls ohne Aufforderung zur Bestätigung durch den Benutzer.

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 dem Computer verfügt, der durch den Parameter ComputerName angegeben wird. 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 von diesem Cmdlet aufgefordert, ein Kennwort einzugeben.

Verwenden Sie den Parameter "DomainCredential ", um ein Benutzerkonto anzugeben, das über die Berechtigung zum Herstellen einer Verbindung mit der Domäne verfügt.

Typ:PSCredential
Position:Named
Standardwert:Current User
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-NewName

Gibt einen neuen Namen für den Computer an. Dieser Parameter ist erforderlich.

Standardnamen können Buchstaben (), (a-zA-Z), Zahlen (0-9) und Bindestriche (), jedoch keine Leerzeichen oder Punkte (-.) enthalten. Der Name darf nicht vollständig aus Ziffern bestehen und darf nicht länger als 63 Zeichen sein.

Typ:String
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-PassThru

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

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Protocol

Gibt an, welches Protokoll zum Umbenennen des Computers verwendet werden soll. Die zulässigen Werte für diesen Parameter sind: WSMan und DCOM. Der Standardwert ist DCOM.

Dieser Parameter wurde in Windows PowerShell 3.0 eingeführt.

Typ:String
Zulässige Werte:DCOM, WSMan
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Restart

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

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-WhatIf

Zeigt, was geschieht, 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

-WsmanAuthentication

Gibt den Mechanismus an, der zum Authentifizieren der Benutzeranmeldeinformationen verwendet wird, wenn dieses Cmdlet das WSMan-Protokoll verwendet. Zulässige Werte für diesen Parameter:

  • Grundlegend
  • CredSSP
  • Standard
  • Digest
  • Kerberos
  • Verhandeln

Der Standardwert lautet Default.

Weitere Informationen zu den Werten dieses Parameters finden Sie unter AuthenticationMechanism Enumeration.

Warnung

Credential Security Service Provider (CredSSP)-Authentifizierung, bei der die Benutzeranmeldeinformationen an einen Remotecomputer übergeben werden, der authentifiziert werden soll, ist für Befehle konzipiert, die eine Authentifizierung für mehrere Ressourcen erfordern, z. B. den Zugriff auf eine Remotenetzwerkfreigabe. Dieser Mechanismus erhöht das Sicherheitsrisiko des Remotevorgangs. Wenn der Remotecomputer kompromittiert ist, können die an ihn übergebenen Anmeldeinformationen zum Steuern > der Netzwerksitzung verwendet werden.

Dieser Parameter wurde in Windows PowerShell 3.0 eingeführt.

Typ:String
Zulässige Werte:Default, Basic, Negotiate, CredSSP, Digest, Kerberos
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

None

Dieses Cmdlet verfügt über keine Parameter, die Eingaben nach Wert übernehmen. Sie können jedoch die Werte der ComputerName - und NewName-Eigenschaften von Objekten an dieses Cmdlet weiterleiten.

Ausgaben

None

Standardmäßig gibt dieses Cmdlet keine Ausgabe zurück.

RenameComputerChangeInfo

Wenn Sie den Parameter PassThru verwenden, gibt dieses Cmdlet ein RenameComputerChangeInfo -Objekt zurück.