Rename-Computer
Renomme un ordinateur.
Syntaxe
Default (Par défaut)
Rename-Computer
[-ComputerName <String>]
[-PassThru]
[-DomainCredential <PSCredential>]
[-LocalCredential <PSCredential>]
[-NewName] <String>
[-Force]
[-Restart]
[-WsmanAuthentication <String>]
[-Protocol <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
L’applet de commande Rename-Computer renomme l’ordinateur local ou un ordinateur distant.
Il 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 local en Server044, puis la redémarre pour effectuer la modification.
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 repose pas sur la communication à distance de 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.
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | Local Computer |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
-Confirm
Vous invite à confirmer avant d’exécuter l’applet de commande.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | False |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | cf |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-DomainCredential
Spécifie un compte d’utilisateur autorisé à se connecter au domaine. Les informations d’identification explicites sont requises pour renommer un ordinateur 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 de commande Get-Credential.
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.
Propriétés du paramètre
| Type: | PSCredential |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Force
Force l’exécution de la commande sans demander la confirmation de l’utilisateur.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | 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 de commande Get-Credential.
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.
Propriétés du paramètre
| Type: | PSCredential |
| Valeur par défaut: | Current User |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-NewName
Spécifie un nouveau nom pour l’ordinateur. Ce paramètre est obligatoire.
Les noms standard peuvent contenir des lettres (a-z), (A-Z), des nombres (0-9) et des traits d’union (-), mais pas d’espaces ou de points (.). Le nom ne se compose pas entièrement de chiffres et ne peut pas comporter plus de 63 caractères.
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | 0 |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
-PassThru
Retourne les résultats de la commande. Sinon, cette applet de commande ne génère aucune sortie.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Protocol
Spécifie le protocole à utiliser pour renommer l’ordinateur. Les valeurs acceptables pour ce paramètre sont : WSMan et DCOM. La valeur par défaut est DCOM.
Ce paramètre a été introduit dans Windows PowerShell 3.0.
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Valeurs acceptées: | DCOM, WSMan |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Restart
Indique que cette applet de commande redémarre l’ordinateur renommé. Un redémarrage est souvent nécessaire pour rendre la modification effective.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-WhatIf
Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande ne s’exécute pas.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | False |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | Wi |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | 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 acceptables pour ce paramètre sont les suivantes :
- Basique
- CredSSP
- Par défaut
- Résumé
- Kerberos
- Négocier
La valeur par défaut est Default.
Pour plus d'informations sur les valeurs de ce paramètre, voir AuthenticationMechanism Enumeration.
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é de l’opération à distance. 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.
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Valeurs acceptées: | Default, Basic, Negotiate, CredSSP, Digest, Kerberos |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
CommonParameters
Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.
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 d’objets vers cette cmdlet.
Sorties
None
Par défaut, cette applet de commande ne retourne aucune sortie.
RenameComputerChangeInfo
Lorsque vous utilisez le paramètre PassThru, cette applet de commande renvoie un objet RenameComputerChangeInfo.
