nslookup

  • Article

S’applique à : Windows Server 2022, Windows Server 2019, Windows Server 2016, Windows Server 2012 R2, Windows Server 2012

Affiche des informations que vous pouvez utiliser pour diagnostiquer l’infrastructure DNS (Domain Name System). Avant d’utiliser cet outil, vous devez vous familiariser avec le fonctionnement du Domain Name Service (DNS). L’outil en ligne de commande nslookup est disponible uniquement si vous avez installé le protocole TCP/IP.

Syntaxe

nslookup [exit | finger | help | ls | lserver | root | server | set | view] [options]

Paramètres

Paramètre Description
nslookup exit Quitte l’outil en ligne de commande nslookup.
nslookup finger Se connecte au serveur finger sur l’ordinateur actuel.
nslookup help Affiche un bref résumé des sous-commandes.
nslookup ls Répertorie les informations d’un domaine DNS.
nslookup lserver Remplace le serveur par défaut par le domaine DNS spécifié.
nslookup root Remplace le serveur par défaut par le serveur pour la racine de l’espace de nom de domaine DNS.
nslookup server Remplace le serveur par défaut par le domaine DNS spécifié.
nslookup set Modifie les paramètres de configuration qui affectent le fonctionnement des recherches.
nslookup set all Imprime les valeurs actuelles des paramètres de configuration.
nslookup set class Modifie la classe de requête. La classe spécifie le groupe de protocoles des informations.
nslookup set d2 Active ou désactive le mode débogage exhaustif. Tous les champs de chaque paquet sont imprimés.
nslookup set debug Active ou désactive le mode débogage.
nslookup set domain Remplace le nom de domaine DNS par défaut par le nom spécifié.
nslookup set port Remplace le port du serveur de noms DNS TCP/UDP par défaut par la valeur spécifiée.
nslookup set querytype Modifie le type d’enregistrement de ressource pour la requête.
nslookup set recurse Indique au serveur de noms DNS d’interroger d’autres serveurs s’il ne dispose pas des informations.
nslookup set retry Définit le nombre de nouvelles tentatives.
nslookup set root Modifie le nom du serveur racine utilisé pour les requêtes.
nslookup set search Ajoute les noms de domaine DNS (Domain Name System) dans la liste de recherche de domaine DNS à la demande jusqu’à ce qu’une réponse soit reçue. Cela s’applique lorsque le jeu et la demande de recherche contiennent au moins un point, mais ne se terminent pas par un point.
nslookup set srchlist Modifie le nom de domaine DNS par défaut et la liste de recherche.
nslookup set timeout Modifie le nombre initial de secondes d’attente d’une réponse à une demande.
nslookup set type Modifie le type d’enregistrement de ressource pour la requête.
nslookup set vc Spécifie d’utiliser ou de ne pas utiliser un circuit virtuel lors de l’envoi de requêtes au serveur.
nslookup view Trie et répertorie la sortie des commandes ou sous-commandes ls précédentes.

Notes

  • L’outil en ligne de commande nslookup a deux modes : interactif et non interactif.

    • Si vous avez besoin de rechercher uniquement une seule partie de données, ou si vous utilisez nslookup dans les scripts, les lignes de commande ou PowerShell, utilisez le mode noninteractive. En mode non actif, également appelé mode commande, le premier paramètre de ligne de commande est le nom ou l’adresse IP de l’ordinateur que vous souhaitez rechercher. Le deuxième paramètre est le nom ou l’adresse IP d’un serveur de noms DNS. Si vous omettez le deuxième argument, nslookup utilise le serveur de noms DNS par défaut.

    • Si vous devez rechercher plusieurs données ou définir plusieurs configurations, vous pouvez utiliser le mode interactif. Pour entrer en mode interactif, tapez un trait d’union (-) au lieu du premier paramètre de la ligne de commande nslookup. Entrez le nom ou l’adresse IP d’un serveur de noms DNS pour le deuxième paramètre. Si vous omettez le deuxième argument, nslookup utilise le serveur de noms DNS par défaut. Vous pouvez également appeler le mode interactif en entrant nslookup simplement à l’invite de commandes, puis en entrant des noms ou des adresses IP pour rechercher dans la ligne de commande interactive.

  • Une fois que vous avez entré nslookup - ou nslookup seul, l’invite de commandes passe à l’invite >interactive. En mode interactif, vous pouvez :

    • Entrez des noms ou des adresses IP, set variables et d’autres options sur des lignes distinctes.
    • Interrompre les commandes interactives à tout moment en appuyant sur Ctrl+B.
    • Quittez, en entrant exit.
    • Traitez une commande intégrée en tant que nom d’ordinateur en le précédant avec le caractère d’échappement (\). Une commande non reconnue est interprétée comme un nom d’ordinateur.

  • Si l’ordinateur à rechercher est une adresse IP et que la requête concerne un A ou type d’enregistrement de ressource PTR, le nom de l’ordinateur est retourné.

  • Si l’ordinateur à rechercher est un nom et n’a pas de point de fin, le nom de domaine DNS par défaut est ajouté au nom. Ce comportement dépend de l’état des sous-commandes définies suivantes : domain, srchlist, defname et search.

  • Si la demande de recherche échoue, l’outil en ligne de commande fournit l’un des messages d’erreur suivants :

    Message d’erreur Description
    délai dépassé Le serveur n’a pas répondu à une demande après un certain temps et un certain nombre de nouvelles tentatives. Vous pouvez définir le délai d’expiration avec la commande nslookup set timeout. Vous pouvez définir le nombre de nouvelles tentatives avec la commande nslookup set retry.
    Aucune réponse du serveur Aucun serveur de noms DNS n’est en cours d’exécution sur l’ordinateur serveur.
    Aucun enregistrement Le serveur de noms DNS n’a pas d’enregistrements de ressources du type de requête actuel pour l’ordinateur, bien que le nom de l’ordinateur soit valide. Le type de requête est spécifié avec la commande nslookup set querytype.
    Domaine inexistant L’ordinateur ou le nom de domaine DNS n’existent pas.
    Connexion refusée ou réseau inaccessible Impossible d’établir la connexion au serveur de noms DNS ou au serveur doigt. Cette erreur se produit généralement avec les requêtes ls et finger .
    Défaillance du serveur Le serveur de noms DNS a trouvé une incohérence interne dans sa base de données et n’a pas pu retourner une réponse valide.
    Refusé Le serveur de noms DNS a refusé de traiter la demande.
    erreur de format Le serveur de noms DNS a trouvé que le paquet de requête n’était pas au format approprié. Cela peut indiquer une erreur dans nslookup.

Exemples

En mode noninteractive nslookup, vous spécifiez des paramètres et des options dans la ligne de commande ou le script Windows. En mode interactif, vous spécifiez des arguments et des options sur des lignes distinctes à l’invite de commandes interactive.

Mode non actif

En mode noninteractive nslookup, le premier paramètre est l’ordinateur à rechercher, et le deuxième paramètre est le serveur de noms DNS à utiliser. Si vous ne spécifiez pas de deuxième paramètre, nslookup utilise le serveur de noms DNS par défaut. Les exemples suivants utilisent nslookup en mode non actif.

  • L’exemple suivant recherche les adresses IP du nom de domaine mydomain.com sur le serveur de noms DNS à 1.1.1.1:

    nslookup mydomain.com 1.1.1.1

  • L’exemple suivant recherche le nom de domaine de l’adresse IP 4.4.4.4 sur le serveur de noms DNS par défaut :

    nslookup 4.4.4.4

  • Pour spécifier des options, vous pouvez utiliser nslookup -<option>. Par exemple, la commande suivante active l’option nslookup debug pour obtenir plus d’informations sur les paquets envoyés.

    nslookup -debug mydomain.com

  • Pour retourner certains types d’enregistrements ou d’informations, utilisez l’option -type=<resourcerecordtype>. Par exemple, la commande suivante retourne uniquement les types d’enregistrements IPv6 :

    nslookup -type=AAAA mydomain.com

  • Vous pouvez combiner des options et des requêtes de type d’enregistrement de ressource dans les lignes de commande. L’exemple suivant active la sortie de débogage, récupère les adresses IPv6 et IPv4, ne tente pas d’utiliser le domaine de recherche, utilise la recherche récursive et utilise le serveur de recherche DNS 1.1.1.1 :

    nslookup -debug -type=A+AAAA -nosearch -recurse mydomain.com 1.1.1.1

Mode interactif

Pour utiliser le mode interactif, entrez - au lieu du premier paramètre d’une ligne de commande nslookup, ou entrez simplement nslookup. L’invite de commandes passe ensuite à l’invite interactive >. Les exemples suivants montrent les commandes en mode interactif.

  • La commande suivante place nslookup en mode interactif et définit 1.1.1.1 comme serveur de recherche DNS par défaut :

    nslookup - 1.1.1.1

  • La commande suivante à l’invite interactive retourne l’option nslookup et les paramètres de paramètre pour le serveur actuel :

    set all

  • La commande suivante à l’invite interactive retourne les adresses IP pour mydomain.com:

    mydomain.com

  • La commande suivante à l’invite interactive modifie le serveur de noms DNS par défaut en 4.4.4.4:

    server 4.4.4.4

  • La commande suivante à l’invite interactive définit le type d’enregistrement de ressource de requête sur HINFO:

    set type=HINFO

  • La commande suivante à l’invite interactive quitte le mode interactif et retourne à l’invite de commandes Windows :

    exit