Afficher et modifier les noms d’hôte

Le nom d’hôte identifie votre machine virtuelle (MV) dans l’interface utilisateur et les opérations Azure. Vous devez d’abord attribuer le nom d’hôte d’une MV dans le champ Nom de la machine virtuelle pendant le processus de création dans le portail Azure. Après avoir créé une MV, vous pouvez afficher et modifier le nom d’hôte via une connexion à distance ou dans le portail Azure.

Afficher les noms d’hôte

Vous pouvez afficher le nom d’hôte de votre MV dans un service cloud à l’aide de l’un des outils suivants.

Portail Azure

Dans le portail Azure, accédez à votre MV, puis sélectionnez Propriétés dans le volet de navigation de gauche. Dans la page Propriétés, vous pouvez afficher le nom d’hôte sous Nom de l’ordinateur.

Capture d’écran montrant la page Propriétés d’une machine virtuelle et mettant en évidence le nom de l’ordinateur.

Bureau à distance

Vous pouvez vous connecter à votre MV à l’aide d’un outil de bureau à distance tel que Bureau à distance (Windows), la communication à distance Windows PowerShell (Windows), SSH (Linux et Windows) ou Bastion (portail Azure). Vous pouvez ensuite afficher le nom d’hôte de plusieurs façons :

  • Tapez le nom d’hôte dans PowerShell, l’invite de commande ou le terminal SSH.
  • Tapez ipconfig /all dans l’invite de commande (uniquement dans Windows).
  • Affichez le nom d’ordinateur dans les paramètres système.

Prérequis

Aucun

API Azure

À partir d’un client REST. suivez ces instructions :

  1. Vérifiez que vous disposez d’une connexion authentifiée au portail Azure. Suivez les étapes présentées dans Créer une application et un principal du service Microsoft Entra pouvant accéder aux ressources.

  2. Envoyez une demande au format suivant :

    GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{vmName}?api-version=2022-11-01`. 
    

    Pour plus d’informations sur les demandes GET pour les machines virtuelles, consultez Machines virtuelles - Get.

  3. Recherchez osProfile, puis l’élément computerName pour trouver le nom d’hôte.

    Avertissement

    Vous pouvez également afficher le suffixe de domaine interne de votre service cloud en exécutant ipconfig /all à partir d'une invite de commandes dans une session de bureau à distance (Windows), ou en exécutant cat /etc/resolv.conf à partir d'un terminal SSH (Linux).

Modifier un nom d’hôte

Vous pouvez modifier le nom d’hôte de n’importe quelle MV en renommant l’ordinateur à partir d’une session de bureau à distance ou en utilisant Exécuter la commande dans le portail Azure.

  1. Modifiez le nom d’hôte.

    • À partir d’une session à distance :

      • Pour Windows, vous pouvez modifier le nom d’hôte à partir de PowerShell à l’aide de la commande Renommer-ordinateur.
      • Pour Linux, vous pouvez modifier le nom d’hôte à l’aide de hostnamectl.
    • Depuis le portail Azure : vous pouvez également utiliser exécuter ces commandes pour rechercher le nom d’hôte de votre MV à partir du portail Azure en utilisant Exécuter la commande. Dans le portail Azure, accédez à votre MV, puis sélectionnez Exécuter la commande dans le volet de navigation de gauche. Sur la page Exécuter la commande dans le portail Azure :

      • Pour Windows, sélectionnez RunPowerShellScript et utilisez Rename-Computer dans le volet Exécuter le script de commande.
      • Pour Linux, sélectionnez RunShellScript et utilisez hostnamectl dans le volet Exécuter le script de commande.

      L’image suivante montre la page Exécuter la commande dans le portail Azure pour une MV Windows.

      Capture d’écran montrant la page Exécuter la commande pour une machine virtuelle Windows et mettant en évidence la fonctionnalité RunPowerShellScript.

  2. Après avoir exécuté Rename-Computer ou hostnamectl sur votre MV, vous devez redémarrer votre MV pour changer le nom d’hôte.

    Modèle de déploiement classique Azure

    Le modèle de déploiement Azure Classic utilise un fichier config que vous pouvez télécharger et charger pour modifier le nom d’hôte. Pour permettre à votre nom d’hôte de référencer vos instances de rôle, vous devez définir la valeur du nom d’hôte dans le fichier de configuration de service associé à chaque rôle. Pour ce faire, ajoutez le nom d’hôte souhaité à l’attribut vmName de l’élément Role. La valeur de l’attribut vmName est utilisée comme base de nom d’hôte pour chaque instance de rôle.

    Par exemple, si vmName est webrole et qu’il existe trois instances de ce rôle, les noms d’hôte des instances s’intitulent webrole0, webrole1 et webrole2. Il n’est pas nécessaire de définir un nom d’hôte pour les machines virtuelles dans le fichier config, car le nom d’hôte d’une MV est renseigné en fonction du nom de la machine virtuelle. Pour en savoir plus sur la configuration d’un service Microsoft Azure, consultez la section Schéma de configuration du service Azure (fichier .cscfg)

    Fichier de configuration de service

    Pour un modèle de déploiement Azure Classic, vous pouvez télécharger le fichier de configuration de service d’un service déployé à partir du volet Configurer du service dans le portail Azure. Pour connaître le nom d’hôte, il vous suffit de rechercher l’attribut vmName associé à l’élément Nom de rôle. Gardez à l’esprit que ce nom d’hôte est utilisé comme base pour le nom d’hôte de chaque instance de rôle. Par exemple, si vmName est webrole et qu’il existe trois instances de ce rôle, les noms d’hôte des instances s’intitulent webrole0, webrole1 et webrole2. Pour plus d'informations, consultez Schéma de configuration d’un Réseau virtuel Azure