Partager via

Rename-Computer

  • Référence
Module:
Microsoft.PowerShell.Management

Renomme un ordinateur.

Syntaxe

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
Valeur par défaut:Local Computer
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-Confirm

Vous demande une confirmation avant d’exécuter l’applet de commande.

Type:SwitchParameter
Alias:cf
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Force

Force l’exécution de la commande sans demander la confirmation de l’utilisateur.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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
Valeur par défaut:Current User
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-PassThru

Retourne les résultats de la commande. Sinon, cette applet de commande ne génère aucune sortie.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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
Alias:wi
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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
Valeurs acceptées:Default, Basic, Negotiate, CredSSP, Digest, Kerberos
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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.

RenameComputerChangeInfo

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.