Rename-Computer
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 Server001
umbenannt. 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 localhost
ein.
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 verfügt über keine Parameter, die die Eingabe nach Wert übernehmen. Sie können jedoch die Werte der Eigenschaften ComputerName und NewName von Objekten über die Pipeline an dieses Cmdlet übergeben.
Ausgaben
None
Standardmäßig gibt dieses Cmdlet keine Ausgabe zurück.
Wenn Sie den PassThru-Parameter verwenden, gibt dieses Cmdlet ein RenameComputerChangeInfo-Objekt zurück.
Hinweise
Dieses Cmdlet ist nur auf Windows-Plattformen verfügbar.