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 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.

$renameParams = @{
    ComputerName = "Srv01"
    NewName = "Server001"
    DomainCredential = "Domain01\Admin01"
    Force = $true
}
Rename-Computer @renameParams

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.

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 invite à confirmer 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 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.

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 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.

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 requis.

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.

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 rendre la modification effective.

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

Affiche ce qui se passerait si l’applet de commande s’exécute. 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 acceptables pour ce paramètre sont les suivantes :

  • De base
  • 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.

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 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.

Notes

Cette applet de commande est disponible uniquement sur les plateformes Windows.