Share via

Rename-Computer

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

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.

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.