Freigeben über

Rename-Computer

  • Referenz
Modul:
Microsoft.PowerShell.Management

Benennt einen Computer um.

Syntax

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

Beschreibung

Dieses Cmdlet ist nur auf der Windows-Plattform verfügbar.

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

Dieses Cmdlet wurde in Windows PowerShell 3.0 eingeführt.

Beispiele

Beispiel 1: Umbenennen des lokalen Computers

Dieser Befehl benennt den lokalen Computer in Server044 um und startet ihn dann neu, 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 Server001umbenannt. 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. Der Standardwert ist der lokale Computer.

Geben Sie den NetBIOS-Namen, eine IP-Adresse oder einen vollqualifizierten Domänennamen eines Remotecomputers 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 Rename-Computer verwenden, auch 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

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

-DomainCredential

Gibt ein Benutzerkonto an, das über die Berechtigung zum Herstellen einer Verbindung mit der Domäne verfügt. Explizite Anmeldeinformationen sind erforderlich, um einen Computer umzubenennen, der einer Domäne beigetreten ist.

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 von diesem Cmdlet aufgefordert, ein Kennwort einzugeben.

Um ein Benutzerkonto anzugeben, das über die Berechtigung zum Herstellen einer Verbindung mit dem Computer verfügt, der durch den Parameter ComputerName angegeben wird, verwenden Sie den Parameter LocalCredential.

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

-Force

Erzwingt die Ausführung des Befehls, ohne eine Benutzerbestätigung zu verlangen.

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. 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 von diesem Cmdlet aufgefordert, ein Kennwort einzugeben.

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

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-z), (A-Z), Zahlen (0-9) und Bindestriche (-) enthalten, jedoch keine Leerzeichen oder Punkte (.). 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 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 den Umbenennungscomputer neu startet. Ein Neustart ist häufig erforderlich, um die Änderung wirksam zu machen.

Typ:SwitchParameter
Position:Named
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

-WsmanAuthentication

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

  • Basic-
  • CredSSP-
  • Standard-
  • Digest-
  • Kerberos-
  • aushandeln

Der Standardwert ist 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 verwendet werden, um > der Netzwerksitzung zu steuern.

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.

Hinweise

Dieses Cmdlet ist nur auf Windows-Plattformen verfügbar.