nslookup

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016, Windows Server 2012 R2 e Windows Server 2012

Exibe informações que você pode usar para diagnosticar a infraestrutura do DNS (Serviço de Nomes de Domínio). Antes de usar essa ferramenta, você deve estar familiarizado com o funcionamento do DNS. A ferramenta de linha de comando nslookup só estará disponível se você tiver instalado o protocolo TCP/IP.

Sintaxe

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

Parâmetros

Parâmetro Descrição
nslookup exit Sai da ferramenta da linha de comando nslookup.
nslookup finger Conecta o servidor finger no computador atual.
nslookup help Exibe um breve resumo de subcomandos.
nslookup ls Lista informações para um domínio DNS.
nslookup lserver Altera o servidor padrão para o domínio DNS especificado.
nslookup root Altera o servidor padrão para o servidor da raiz do espaço de nome de domínio do DNS.
nslookup server Altera o servidor padrão para o domínio DNS especificado.
nslookup set Altera as definições de configuração que afetam como as pesquisas funcionam.
nslookup set all Imprime os valores atuais das definições de configuração.
nslookup set class Altera a classe de consulta. A classe especifica o grupo de protocolos das informações.
nslookup set d2 Ativa ou desativa o modo de depuração exaustiva. Todos os campos de cada pacote são impressos.
nslookup set debug Ativa ou desativa o modo de depuração.
nslookup set domain Altera o nome de domínio DNS padrão para o nome especificado.
nslookup set port Altera a porta do servidor de nome DNS TCP/UDP padrão para o valor especificado.
nslookup set querytype Altera o tipo de registro de recurso da consulta.
nslookup set recurse Informa ao servidor de nomes DNS para consultar outros servidores se ele não tiver as informações.
nslookup set retry Define o número de repetições.
nslookup set root Altera o nome do servidor raiz usado para consultas.
nslookup set search Acrescenta os nomes de domínio DNS na lista de pesquisa de domínios DNS à solicitação até que uma resposta seja recebida. Isso se aplica quando o conjunto e a solicitação de pesquisa contêm, pelo menos, um ponto, mas não terminam com um ponto à direita.
nslookup set srchlist Altera o nome de domínio DNS padrão e a lista de pesquisa.
nslookup set timeout Altera o número inicial de segundos para aguardar uma resposta a uma solicitação.
nslookup set type Altera o tipo de registro de recurso da consulta.
nslookup set vc Especifica se um circuito virtual deve ser usado ou não ao enviar solicitações para o servidor.
nslookup view Classifica e lista a saída dos subcomandos ou dos comandos ls anteriores.

Comentários

  • A ferramenta de linha de comando nslookup tem dois modos: interativo e não interativo.

    • Se precisar procurar apenas um único dado ou estiver usando o nslookup em scripts, linhas de comando ou no PowerShell, use o modo não interativo. No modo não interativo, também chamado de modo de comando, o primeiro parâmetro da linha de comando é o nome ou o endereço IP do computador que você deseja consultar. O segundo parâmetro é o nome ou o endereço IP de um servidor de nomes DNS. Se você omitir o segundo argumento, o nslookup usará o servidor de nomes DNS padrão.

    • Se você precisar pesquisar mais de um dado ou definir várias configurações, poderá usar o modo interativo. Para entrar no modo interativo, digite um hífen (-) em vez do primeiro parâmetro na linha de comando do nslookup. Insira o nome ou o endereço IP de um servidor de nomes DNS para o segundo parâmetro. Se você omitir o segundo argumento, o nslookup usará o servidor de nomes DNS padrão. Você também pode invocar o modo interativo simplesmente inserindo nslookup no prompt de comando e, em seguida, inserindo nomes ou endereços IP para pesquisar na linha de comando interativa.

  • Quando você insere nslookup - ou nslookup sozinho, o prompt de comando é alterado para o prompt interativo >. Enquanto estiver no modo interativo, você pode:

    • Insira nomes ou endereços IP, variáveis set e outras opções em linhas separadas.
    • Interrompa os comandos interativos a qualquer momento pressionando CTRL+B.
    • Saia, inserindo exit.
    • Trate um comando interno como um nome de computador, precedendo-o com o caractere de escape (\). Um comando não reconhecido é interpretado como um nome de computador.
  • Se o computador a ser localizado for um endereço IP e a consulta for para um tipo de registro de recurso A ou PTR, o nome do computador será retornado.

  • Se o computador a ser localizado for um nome e não tiver um ponto final, o nome de domínio DNS padrão será acrescentado ao nome. Esse comportamento depende do estado dos seguintes subcomandos set: domain, srchlist, defname e search.

  • Se a solicitação de pesquisa falhar, a ferramenta de linha de comando fornecerá uma das seguintes mensagens de erro:

    Mensagem de erro Descrição
    tempo limite atingido O servidor não respondeu a uma solicitação após um determinado período de tempo e um determinado número de repetições. Você pode definir o período de tempo limite com o comando nslookup set timeout. Você pode definir o número de repetições com o comando nslookup set retry.
    Sem resposta do serviço Nenhum servidor de nomes DNS está em execução no computador do servidor.
    Sem registros O servidor de nomes DNS não tem registros de recurso do tipo de consulta atual para o computador, embora o nome do computador seja válido. O tipo de consulta é especificado com o comando nslookup set querytype.
    Domínio inexistente O computador ou o nome de domínio DNS não existe.
    Conexão recusada ou Rede inacessível Não foi possível fazer a conexão com o servidor de nomes DNS ou o servidor finger. Esse erro geralmente ocorre com as solicitações ls e finger.
    Falha do servidor O servidor de nomes DNS encontrou uma inconsistência interna em seu banco de dados e não pôde retornar uma resposta válida.
    Recusado O servidor de nome DNS se recusou a atender à solicitação.
    erro de formato O servidor de nome DNS descobriu que o pacote de solicitação não estava no formato adequado. Pode indicar um erro no nslookup.

Exemplos

No modo não interativo do nslookup, você especifica parâmetros e opções na linha de comando ou no script do Windows. No modo interativo, você especifica argumentos e opções em linhas separadas no prompt de comando interativo.

Modo não interativo

No modo não interativo do nslookup, o primeiro parâmetro é o computador a ser localizado e o segundo parâmetro é o servidor de nomes DNS a ser usado. Se você não especificar um segundo parâmetro, o nslookup usará o servidor de nomes DNS padrão. Os exemplos a seguir usam nslookup no modo não interativo.

  • O exemplo a seguir procura os endereços IP do nome de domínio mydomain.com no servidor de nomes DNS em 1.1.1.1:

    nslookup mydomain.com 1.1.1.1
    
  • O exemplo a seguir procura o nome de domínio do endereço IP 4.4.4.4 no servidor de nomes DNS padrão:

    nslookup 4.4.4.4
    
  • Para especificar as opções, você pode usar nslookup -<option>. Por exemplo, o comando a seguir ativa a opção nslookup debug para obter mais informações sobre pacotes enviados.

    nslookup -debug mydomain.com
    
  • Para retornar determinados tipos de registros ou informações, use a opção -type=<resourcerecordtype>. Por exemplo, o comando a seguir retorna apenas os tipos de registro IPv6:

    nslookup -type=AAAA mydomain.com
    
  • É possível combinar opções e consultas de tipo de registro de recursos em linhas de comando. O exemplo a seguir habilita a saída de depuração, recupera endereços IPv6 e IPv4, não tenta usar o domínio de pesquisa, usa pesquisa recursiva e usa o servidor de pesquisa DNS 1.1.1.1:

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

Modo interativo

Para usar o modo interativo, insira - em vez do primeiro parâmetro de uma linha de comando nslookup ou simplesmente insira nslookup. Em seguida, o prompt de comando muda para o prompt interativo >. Os exemplos a seguir mostram comandos do modo interativo.

  • O comando a seguir coloca o nslookup no modo interativo e define 1.1.1.1 como o servidor de pesquisa DNS padrão:

    nslookup - 1.1.1.1
    
  • O comando a seguir no prompt interativo retorna as configurações de parâmetros e opções do nslookup para o servidor atual:

    set all
    
  • O comando a seguir no prompt interativo retorna os endereços IP de mydomain.com:

    mydomain.com
    
  • O comando a seguir no prompt interativo altera o servidor de nomes DNS padrão para 4.4.4.4:

    server 4.4.4.4
    
  • O comando a seguir no prompt interativo define o tipo de registro do recurso de consulta como HINFO:

    set type=HINFO
    
  • O comando a seguir no prompt interativo sai do modo interativo e retorna ao prompt de comando do Windows:

    exit