Share via

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 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 in Server044 umbenannt und dann neu gestartet, damit die Änderung wirksam wird.

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 Force-Parameter 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 localhostein.

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

Type:String
Position:Named
Default value:Local Computer
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

-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, z User01 . B. oder Domain01\User01, oder geben Sie ein PSCredential-Objekt ein, z. B. ein vom Get-Credential Cmdlet generiertes Objekt.

Wenn Sie einen Benutzernamen eingeben, werden Sie von diesem Cmdlet zur Eingabe eines Kennworts aufgefordert.

Geben Sie ein Benutzerkonto, das über die Berechtigung zum Herstellen einer Verbindung mit dem durch den ComputerName-Parameter angegebenen Computer verfügt, mit dem LocalCredential-Parameter an.

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

-Force

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

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 dem durch den ComputerName-Parameter angegebenen Computer verfügt. Der Standardwert ist der aktuelle Benutzer.

Geben Sie einen Benutzernamen ein, z User01 . B. oder Domain01\User01, oder geben Sie ein PSCredential-Objekt ein, z. B. ein vom Get-Credential Cmdlet generiertes Objekt.

Wenn Sie einen Benutzernamen eingeben, werden Sie von diesem Cmdlet zur Eingabe eines Kennworts aufgefordert.

Geben Sie ein Benutzerkonto, das über die Berechtigung zum Herstellen einer Verbindung mit der Domäne verfügt, mit dem DomainCredential-Parameter an.

Type:PSCredential
Position:Named
Default value:Current User
Required:False
Accept pipeline input:False
Accept wildcard characters: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,- aber keine Leerzeichen oder Punkte (.). Der Name besteht möglicherweise nicht vollständig aus Ziffern und darf nicht länger als 63 Zeichen sein.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
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 den umbenannten Computer neu startet. Ein Neustart ist häufig erforderlich, damit die Änderung wirksam wird.

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

-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
  • Aushandeln

Der Standardwert lautet Default.

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

Warnung

Die CredSSP-Authentifizierung (Credential Security Service Provider), bei der die Benutzeranmeldeinformationen an einen Remotecomputer zur Authentifizierung übergeben werden, ist für Befehle konzipiert, die die 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.

Type:String
Accepted values:Default, Basic, Negotiate, CredSSP, Digest, Kerberos
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Eingaben

None

Dieses Cmdlet enthält keine Parameter, die eine Eingabe nach Wert annehmen. Sie können jedoch die Werte der Eigenschaften ComputerName und NewName von Objekten über die Pipeline an dieses Cmdlet übergeben.

Ausgaben

ComputerChangeInfo

Dieses Cmdlet gibt ein ComputerChangeInfo-Objekt zurück, wenn Sie den PassThru-Parameter angeben. Andernfalls wird keine Ausgabe zurückgegeben.

Hinweise

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