Rename-Computer
Renomme un ordinateur.
Syntax
Rename-Computer
[-ComputerName <String>]
[-PassThru]
[-DomainCredential <PSCredential>]
[-LocalCredential <PSCredential>]
[-NewName] <String>
[-Force]
[-Restart]
[-WsmanAuthentication <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Cette applet de commande est disponible uniquement sur la plateforme Windows.
L’applet Rename-Computer
de commande renomme l’ordinateur local ou un ordinateur distant.
Elle renomme un ordinateur dans chaque commande.
Cette applet de commande a été introduite dans Windows PowerShell 3.0.
Exemples
Exemple 1 : Renommer l’ordinateur local
Cette commande renomme l’ordinateur Server044
local, puis la redémarre pour que la modification soit effective.
Rename-Computer -NewName "Server044" -DomainCredential Domain01\Admin01 -Restart
Exemple 2 : Renommer un ordinateur distant
Cette commande renomme l’ordinateur Srv01
en Server001
. L’ordinateur n’est pas redémarré.
Le paramètre DomainCredential spécifie les informations d’identification d’un utilisateur autorisé à renommer des ordinateurs dans le domaine.
Le paramètre Force supprime l’invite de confirmation.
Rename-Computer -ComputerName "Srv01" -NewName "Server001" -DomainCredential Domain01\Admin01 -Force
Paramètres
-ComputerName
Renomme l’ordinateur distant spécifié. La valeur par défaut est l'ordinateur local.
Tapez le nom NetBIOS, une adresse IP ou un nom de domaine complet d'un ordinateur distant.
Pour spécifier l’ordinateur local, tapez le nom de l’ordinateur, un point (.
) ou localhost
.
Ce paramètre ne s’appuie pas sur la communication à distance PowerShell.
Vous pouvez utiliser le paramètre ComputerName de Rename-Computer
même si votre ordinateur n’est pas configuré pour exécuter des commandes distantes.
Type: | String |
Position: | Named |
Default value: | Local Computer |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Confirm
Vous demande une confirmation avant d’exécuter l’applet de commande.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DomainCredential
Spécifie un compte d’utilisateur qui a l’autorisation de se connecter au domaine. Des informations d’identification explicites sont requises pour renommer un ordinateur qui est joint à un domaine.
Tapez un nom d’utilisateur, tel que User01
ou Domain01\User01
, ou entrez un objet PSCredential , tel qu’un objet généré par l’applet Get-Credential
de commande.
Si vous tapez un nom d’utilisateur, cette applet de commande vous invite à entrer un mot de passe.
Pour spécifier un compte d’utilisateur autorisé à se connecter à l’ordinateur spécifié par le paramètre ComputerName , utilisez le paramètre LocalCredential .
Type: | PSCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Force
Force l’exécution de la commande sans demander la confirmation de l’utilisateur.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-LocalCredential
Spécifie un compte d’utilisateur autorisé à se connecter à l’ordinateur spécifié par le paramètre ComputerName . La valeur par défaut est l’utilisateur actuel.
Tapez un nom d’utilisateur, tel que User01
ou Domain01\User01
, ou entrez un objet PSCredential , tel qu’un objet généré par l’applet Get-Credential
de commande.
Si vous tapez un nom d’utilisateur, cette applet de commande vous invite à entrer un mot de passe.
Pour spécifier un compte d’utilisateur autorisé à se connecter au domaine, utilisez le paramètre DomainCredential .
Type: | PSCredential |
Position: | Named |
Default value: | Current User |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-NewName
Spécifie un nouveau nom pour l’ordinateur. Ce paramètre est obligatoire.
Les noms standard peuvent contenir des lettres (), (A-Z
), des chiffres (0-9
) et des traits d’union (-
), mais pas d’espaces ou de points (.
).a-z
Le nom ne se compose pas entièrement de chiffres et ne peut pas comporter plus de 63 caractères.
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-PassThru
Retourne les résultats de la commande. Sinon, cette applet de commande ne génère aucune sortie.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Restart
Indique que cette applet de commande redémarre l’ordinateur renommé. Un redémarrage est souvent nécessaire pour que le changement devienne effectif.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WsmanAuthentication
Spécifie le mécanisme utilisé pour authentifier les informations d’identification de l’utilisateur lorsque cette applet de commande utilise le protocole WSMan. Les valeurs valides pour ce paramètre sont :
- De base
- CredSSP
- Par défaut
- Digest
- Kerberos
- Négocier
La valeur par défaut est Default.
Pour plus d’informations sur les valeurs de ce paramètre, consultez AuthenticationMechanism, énumération.
Avertissement
L’authentification CredSSP (Credential Security Service Provider), dans laquelle les informations d’identification de l’utilisateur sont transmises à un ordinateur distant à authentifier, est conçue pour les commandes qui nécessitent une authentification sur plusieurs ressources, telles que l’accès à un partage réseau distant. Ce mécanisme augmente le risque de sécurité lié à l'opération distante. Si l’ordinateur distant est compromis, les informations d’identification qui lui sont transmises peuvent être utilisées pour contrôler > la session réseau.
Ce paramètre a été introduit dans Windows PowerShell 3.0.
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 |
Entrées
None
Cette applet de commande n’a aucun paramètre qui prend l’entrée par valeur. Toutefois, vous pouvez diriger les valeurs des propriétés ComputerName et NewName des objets vers cette applet de commande.
Sorties
None
Par défaut, cette applet de commande ne retourne aucune sortie.
Lorsque vous utilisez le paramètre PassThru , cette applet de commande renvoie un objet RenameComputerChangeInfo .
Notes
Cette applet de commande est disponible uniquement sur les plateformes Windows.
Liens associés
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour