Método EnableDNS da classe Win32_NetworkAdapterConfiguration

Artigo
06/12/2023

O método estático da classe WMIEnableDNS habilita o DNS (Sistema de Nomes de Domínio) para o serviço.

Este tópico usa a sintaxe MOF (Managed Object Format). Para obter mais informações sobre como usar esse método, consulte Chamando um método.

Sintaxe

uint32 EnableDNS(
  [in, optional] string DNSHostName,
  [in, optional] string DNSDomain,
  [in, optional] string DNSServerSearchOrder[],
  [in, optional] string DNSDomainSuffixSearchOrder[]
);

Parâmetros

DNSHostName [in, opcional]

Nome do host DNS habilitado por esse método.

Exemplo: "corpdns"

DNSDomain [in, opcional]

Representa um nome de organização seguido por um ponto e uma extensão que indica o tipo de organização.

Exemplo: "microsoft.com"

DNSServerSearchOrder [in, opcional]

Lista de endereços IP do servidor a serem consultados para servidores DNS.

DNSDomainSuffixSearchOrder [in, opcional]

Sufixo de domínio DNS que é acrescentado a um nome de host durante a resolução de nomes. Ao resolver um FQDN (nome de domínio totalmente qualificado) de um nome somente de host, o sistema acrescenta o nome de domínio local. Se a resolução de nomes não for bem-sucedida, o sistema usará a lista de sufixos de domínio para criar FQDNs adicionais na ordem listada e, em seguida, consultará servidores DNS para cada um deles.

Valor retornado

Retorna um valor de 0 (zero) para uma conclusão bem-sucedida quando uma reinicialização não é necessária, 1 (um) para uma conclusão bem-sucedida quando uma reinicialização é necessária e qualquer outro número, se houver um erro. Para obter mais informações sobre códigos de erro, consulte Constantes de erro WMI ou WbemErrorEnum. Para obter valores gerais de HRESULT , consulte Códigos de erro do sistema.

Conclusão bem-sucedida, nenhuma reinicialização necessária

Conclusão bem-sucedida, nenhuma reinicialização é necessária.

Conclusão bem-sucedida, reinicialização necessária

Conclusão bem-sucedida, reinicialização necessária.

Método sem suporte nesta plataforma

Método sem suporte nesta plataforma.

Falha desconhecida

Falha desconhecida.

Máscara de sub-rede inválida

Máscara de sub-rede inválida.

Ocorreu um erro ao processar uma Instância que foi retornada

Ocorreu um erro ao processar uma instância que foi retornada.

Parâmetro de entrada inválido

Parâmetro de entrada inválido.

Mais de 5 gateways especificados

Mais de cinco gateways especificados.

Endereço IP inválido

Endereço IP inválido.

Endereço IP de gateway inválido

Endereço IP de gateway inválido.

Erro ao acessar o Registro para obter as informações solicitadas

Ocorreu um erro ao acessar o registro para obter as informações solicitadas.

Nome de domínio inválido

Nome de domínio inválido.

Nome de host inválido

Nome de host inválido.

Nenhum servidor WINS primário/secundário definido

Nenhum servidor WINS primário ou secundário definido.

Arquivo inválido

Arquivo inválido.

Caminho do sistema inválido

Caminho do sistema inválido.

Falha na cópia do arquivo

Falha na cópia do arquivo.

Parâmetro de segurança inválido

Parâmetro de segurança inválido.

Não é possível configurar o serviço TCP/IP

Não é possível configurar o serviço TCP/IP.

Não é possível configurar o serviço DHCP

Não é possível configurar o serviço DHCP.

Não é possível renovar a concessão de DHCP

Não é possível renovar a concessão de DHCP.

Não é possível liberar a concessão de DHCP

Não é possível liberar a concessão de DHCP.

IP não habilitado no adaptador

IP não habilitado no adaptador.

IPX não habilitado no adaptador

IPX não habilitado no adaptador.

Erro de limites de número de quadro/rede

Erro de limites de quadro ou número de rede.

Tipo de quadro inválido

Tipo de quadro inválido.

Número de rede inválido

Número de rede inválido.

Número de rede duplicado

Número de rede duplicado.

Parâmetro fora dos limites

Parâmetro fora dos limites.

Acesso negado

Acesso negado.

Memória insuficiente

Sem memória.

Já existe

Já existe.

Caminho, arquivo ou objeto não encontrado

Caminho, arquivo ou objeto não encontrado.

Não é possível notificar o serviço

Não é possível notificar o serviço.

Não é possível notificar o serviço DNS

Não é possível notificar o serviço DNS.

Interface não configurável

Interface não configurável.

Nem todas as concessões dhcp poderiam ser liberadas/renovadas

Nem todas as concessões DHCP podem ser liberadas ou renovadas.

DHCP não habilitado no adaptador

100

O DHCP não está habilitado no adaptador.

Outros

101 4294967295

Exemplos

O exemplo de código a seguir, obtido do exemplo de código Habilitar DNS em Todos os Adaptadores de Rede VBScript na Galeria do TechNet, habilita o DNS para todos os adaptadores de rede em um computador.

On Error Resume Next 
 
strComputer = "." 
Set objWMIService = GetObject("winmgmts:" _ 
    & "{impersonationLevel=impersonate}!\\" & strComputer & "\root\cimv2") 
 
Set objNetworkSettings = objWMIService.Get("Win32_NetworkAdapterConfiguration") 
strHostName = "fabrikam1" 
arrDNSSuffixes = Array("hr.fabrikam.com", "research.fabrikam.com") 
objNetworkSettings.EnableDNS strHostName, , , arrDNSSuffixes

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista
Servidor mínimo com suporte	Windows Server 2008
Namespace	Root\CIMV2
MOF	CIMWin32.mof
DLL	CIMWin32.dll

Confira também

Classes de hardware do sistema de computador
Win32_NetworkAdapterConfiguration
Tarefas do WMI: Rede
Tarefas do WMI: contas e domínios
Suporte a IPv6 e IPv4 no WMI