nslookup

Artículo
10/06/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016, Windows Server 2012 R2 y Windows Server 2012.

Muestra información que puede usar para diagnosticar la infraestructura del Sistema de nombres de dominio (DNS). Antes de usar esta herramienta, debe estar familiarizado con el funcionamiento del DNS. La herramienta de línea de comandos nslookup solo está disponible si ha instalado el protocolo TCP/IP.

Sintaxis

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

Parámetros

Parámetro	Descripción
nslookup exit	Sale de la herramienta de línea de comandos nslookup.
nslookup finger	Se conecta con el servidor de dedo en el equipo actual.
nslookup help	Muestra un breve resumen de los subcomandos.
nslookup ls	Muestra información de un dominio DNS.
nslookup lserver	Cambia el servidor predeterminado al dominio DNS especificado.
nslookup root	Cambia el servidor predeterminado al servidor para la raíz del espacio de nombres de dominio DNS.
nslookup server	Cambia el servidor predeterminado al dominio DNS especificado.
nslookup set	Cambia los valores de configuración que afectan a cómo funcionan las búsquedas.
nslookup set all	Imprime los valores actuales de los valores de configuración.
nslookup set class	Cambia la clase de consulta. La clase especifica el grupo de protocolos de la información.
nslookup set d2	Activa o desactiva el modo de depuración exhaustivo. Se imprimen todos los campos de cada paquete.
nslookup set debug	Activa o desactiva el modo de depuración.
nslookup set domain	Cambia el nombre de dominio DNS predeterminado al nombre especificado.
nslookup set port	Cambia el puerto predeterminado del servidor de nombres DNS TCP/UDP al valor especificado.
nslookup set querytype	Cambia el tipo de registro de recursos de la consulta.
nslookup set recurse	Indica al servidor de nombres DNS que consulte otros servidores si no tiene la información.
nslookup set retry	Establece el número de reintentos.
nslookup set root	Cambia el nombre del servidor raíz usado para las consultas.
nslookup set search	Anexa los nombres de dominio de DNS de la lista de búsqueda de dominios DNS a la solicitud hasta que se recibe una respuesta. Esto se aplica cuando el conjunto y la solicitud de búsqueda contienen al menos un período, pero no terminan con un período final.
nslookup set srchlist	Cambia el nombre de dominio DNS predeterminado y la lista de búsqueda.
nslookup set timeout	Cambia el número inicial de segundos para esperar una respuesta a una solicitud.
nslookup set type	Cambia el tipo de registro de recursos de la consulta.
nslookup set vc	Especifica el uso o no de un circuito virtual al enviar solicitudes al servidor.
nslookup view	Ordena y enumera la salida de los comandos o subcomandos ls anteriores.

Comentarios

La herramienta de línea de comandos nslookup tiene dos modos: interactivo y no interactivo.
- Si necesita buscar solo un solo fragmento de datos o usa nslookup en scripts, líneas de comandos o PowerShell, use el modo no interactivo. En el modo no interactivo, también denominado modo de comandos, el primer parámetro de la línea de comandos es el nombre o la dirección IP del equipo que quiere buscar. El segundo parámetro es el nombre o la dirección IP de un servidor de nombres DNS. Si omite el segundo argumento, nslookup usa el servidor de nombres DNS predeterminado.
- Si necesita buscar más de un fragmento de datos o establecer varias configuraciones, puede usar el modo interactivo. Para especificar el modo interactivo, escriba un guión (-) en lugar del primer parámetro de la línea de comandos de nslookup. Para el segundo parámetro, escriba el nombre o la dirección IP de un servidor de nombres DNS. Si omite el segundo argumento, nslookup usa el servidor de nombres DNS predeterminado. También puede invocar el modo interactivo si simplemente escribe nslookup en el símbolo del sistema y, después, nombres o direcciones IP para buscar en la línea de comandos interactiva.
Una vez que escriba nslookup - o nslookup solo, el símbolo del sistema cambia al símbolo del sistema interactivo >. En el modo interactivo, puede hacer lo siguiente:
- Escribir nombres o direcciones IP, variables set y otras opciones en líneas independientes.
- Interrumpir los comandos interactivos en cualquier momento si presiona CTRL+B.
- Salir, si escribe exit.
- Tratar un comando integrado como un nombre de equipo si lo precede de un carácter de escape (\). Un comando no reconocido se interpreta como un nombre de equipo.
Si el equipo que quiere buscar es una dirección IP y la consulta es para un tipo de registro de recursos A o PTR, se devuelve el nombre del equipo.
Si el equipo que quiere buscar es un nombre y no tiene un punto final, el nombre de dominio DNS predeterminado se anexa al nombre. Este comportamiento depende del estado de los siguientes subcomandos set: domain, srchlist, defname y search.

Si se produce un error en la solicitud de búsqueda, la herramienta de línea de comandos proporciona uno de los mensajes de error siguientes:

Mensaje de error	Descripción
agotarse el tiempo de espera	El servidor no respondió a una solicitud después de un período de tiempo determinado y un número determinado de reintentos. Puede establecer el período de tiempo de espera con el comando nslookup set timeout. Puede establecer el número de reintentos con el comando nslookup set retry.
Sin respuesta del servidor	No se ejecuta ningún servidor de nombres DNS en el equipo del servidor.
Ningún registro	El servidor de nombres DNS no tiene registros de recursos del tipo de consulta actual para el equipo, aunque el nombre del equipo es válido. El tipo de consulta se especifica con el comando nslookup set querytype.
Dominio inexistente	El equipo o el nombre de dominio DNS no existen.
La conexión rechazada o la red no es accesible	No se pudo establecer la conexión con el servidor de nombres DNS o el servidor de finger. Este error suele producirse con las solicitudes ls y finger.
Error de servidor	El servidor de nombres DNS encontró una incoherencia interna en su base de datos y no pudo devolver una respuesta válida.
Rechazado	El servidor de nombres DNS rechazó atender la solicitud.
Error de formato	El servidor de nombres DNS encontró que el paquete de solicitud no tenía el formato adecuado. Puede indicar un error en nslookup.

Ejemplos

En el modo no interactivo de nslookup, se especifican parámetros y opciones en la línea de comandos o script de Windows. En el modo interactivo, se especifican argumentos y opciones en líneas independientes en el símbolo del sistema interactivo.

Modo no interactivo

En el modo no interactivo de nslookup, el primer parámetro es el equipo que se va a buscar y el segundo parámetro es el servidor de nombres DNS que se va a usar. Si no especifica un segundo parámetro, nslookup usa el servidor de nombres DNS predeterminado. En los ejemplos siguientes se usa nslookup en modo no interactivo.

En el ejemplo siguiente se buscan las direcciones IP del nombre de dominio mydomain.com en el servidor de nombres DNS en 1.1.1.1:
```
nslookup mydomain.com 1.1.1.1
```
En el ejemplo siguiente se busca el nombre de dominio de la dirección IP 4.4.4.4 en el servidor de nombres DNS predeterminado:
```
nslookup 4.4.4.4
```
Para especificar opciones, puede usar nslookup -<option>. Por ejemplo, el siguiente comando activa la opción debug de nslookup para obtener más información sobre los paquetes enviados.
```
nslookup -debug mydomain.com
```
Para devolver determinados tipos de registros o información, use la opción -type=<resourcerecordtype>. Por ejemplo, el siguiente comando devuelve solo los tipos de registro IPv6:
```
nslookup -type=AAAA mydomain.com
```
Puede combinar opciones y consultas de tipo de registro de recursos en líneas de comandos. En el ejemplo siguiente se habilita la salida de depuración, se recuperan las direcciones IPv6 e IPv4, no se intenta usar el dominio de búsqueda, se usa la búsqueda recursiva y se utiliza el servidor de búsqueda DNS 1.1.1.1:
```
nslookup -debug -type=A+AAAA -nosearch -recurse mydomain.com 1.1.1.1
```

Modo interactivo

Para usar el modo interactivo, escriba - en lugar del primer parámetro de una línea de comandos de nslookup, o bien simplemente escriba nslookup. Después, el símbolo del sistema cambia al símbolo del sistema interactivo >. En los ejemplos siguientes se muestran comandos en modo interactivo.

El siguiente comando coloca nslookup en modo interactivo y establece 1.1.1.1 como el servidor de búsqueda DNS predeterminado:
```
nslookup - 1.1.1.1
```
El siguiente comando en el símbolo del sistema interactivo devuelve la opción nslookup y la configuración de parámetros del servidor actual:
```
set all
```
El siguiente comando en el símbolo del sistema interactivo devuelve las direcciones IP de mydomain.com:
```
mydomain.com
```
El siguiente comando en el símbolo del sistema interactivo cambia el servidor de nombres DNS predeterminado a 4.4.4.4:
```
server 4.4.4.4
```
El siguiente comando en el símbolo del sistema interactivo establece el tipo de registro de recursos de consulta en HINFO:
```
set type=HINFO
```
El siguiente comando en el símbolo del sistema interactivo sale del modo interactivo y vuelve al símbolo del sistema de Windows:
```
exit
```

Clave de sintaxis de línea de comandos