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
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 local en Server044
, puis le 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 repose 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 à distance.
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 de Get-Credential
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 qui a l’autorisation de 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 qui a l’autorisation de 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 Get-Credential
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 qui a l’autorisation de 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 peut pas se composer 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 qui a été 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
- Negotiate
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 pour être authentifiées, 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 pas de paramètres qui acceptent une 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
Cette applet de commande renvoie un objet ComputerChangeInfo , si vous spécifiez le paramètre PassThru . Sinon, elle ne retourne aucune sortie.
Notes
Cette applet de commande est disponible uniquement sur les plateformes Windows.