Método SetDNSSuffixSearchOrder da classe Win32_NetworkAdapterConfiguration
O método estático da classe WMISetDNSSuffixSearchOrder usa uma matriz de elementos de cadeia de caracteres para definir a ordem de pesquisa do sufixo.
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 SetDNSSuffixSearchOrder(
[in] string DNSDomainSuffixSearchOrder[]
);
Parâmetros
-
DNSDomainSuffixSearchOrder [in]
-
Lista de sufixos de servidor a serem consultados para servidores DNS. O local do registro do sufixo DNS é HKEY_LOCAL_MACHINE\System\CurrentControlSet\Services\Tcpip| Nameserver
Exemplo: "suffix1.company.com", "suffix2.company.com"
Valor retornado
Retorna um valor de 0 (zero) para uma conclusão bem-sucedida quando nenhuma reinicialização é necessária, 1 (um) para uma conclusão bem-sucedida quando uma reinicialização é necessária e um número diferente 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
-
0
Conclusão bem-sucedida, nenhuma reinicialização necessária.
-
Conclusão bem-sucedida, reinicialização necessária
-
1
Conclusão bem-sucedida, reinicialização necessária.
-
Método sem suporte nesta plataforma
-
64
Método sem suporte nesta plataforma.
-
Falha desconhecida
-
65
Falha desconhecida.
-
Máscara de sub-rede inválida
-
66
Máscara de sub-rede inválida.
-
Ocorreu um erro ao processar uma Instância que foi retornada
-
67
Ocorreu um erro ao processar uma instância que foi retornada.
-
Parâmetro de entrada inválido
-
68
Parâmetro de entrada inválido.
-
Mais de 5 gateways especificados
-
69
Mais de cinco gateways especificados.
-
Endereço IP inválido
-
70
Endereço IP inválido.
-
Endereço IP do gateway inválido
-
71
Endereço IP do gateway inválido.
-
Ocorreu um erro ao acessar o Registro para obter as informações solicitadas
-
72
Ocorreu um erro ao acessar o registro para obter as informações solicitadas.
-
Nome de domínio inválido
-
73
Nome de domínio inválido.
-
Nome do host inválido
-
74
Nome do host inválido.
-
Nenhum servidor WINS primário/secundário definido
-
75
Nenhum servidor WINS primário ou secundário definido.
-
Arquivo inválido
-
76
Arquivo inválido.
-
Caminho do sistema inválido
-
77
Caminho do sistema inválido.
-
Falha na cópia do arquivo
-
78
Falha na cópia do arquivo.
-
Parâmetro de segurança inválido
-
79
Parâmetro de segurança inválido.
-
Não é possível configurar o serviço TCP/IP
-
80
Não é possível configurar o serviço TCP/IP.
-
Não é possível configurar o serviço DHCP
-
81
Não é possível configurar o serviço DHCP.
-
Não é possível renovar a concessão do DHCP
-
82
Não é possível renovar a concessão do DHCP.
-
Não é possível liberar a concessão do DHCP
-
83
Não é possível liberar a concessão do DHCP.
-
IP não habilitado no adaptador
-
84
IP não habilitado no adaptador.
-
IPX não habilitado no adaptador
-
85
IPX não habilitado no adaptador.
-
Erro de limites de número de quadro/rede
-
86
Erro de limites de quadro ou número de rede.
-
Tipo de quadro inválido
-
87
Tipo de quadro inválido.
-
Número de rede inválido
-
88
Número de rede inválido.
-
Número de rede duplicado
-
89
Número de rede duplicado.
-
Parâmetro fora dos limites
-
90
Parâmetro fora dos limites.
-
Acesso negado
-
91
Acesso negado.
-
Memória insuficiente
-
92
Sem memória.
-
Já existe
-
93
Já existe.
-
Caminho, arquivo ou objeto não encontrado
-
94
Caminho, arquivo ou objeto não encontrado.
-
Não é possível notificar o serviço
-
95
Não é possível notificar o serviço.
-
Não é possível notificar o serviço DNS
-
96
Não é possível notificar o serviço DNS.
-
Interface não configurável
-
97
Interface não configurável.
-
Nem todas as concessões dhcp poderiam ser liberadas/renovadas
-
98
Nem todas as concessões DHCP são liberadas ou renovadas.
-
DHCP não habilitado no adaptador
-
100
O DHCP não está habilitado no adaptador.
-
Outros
-
101 4294967295
Comentários
Essa é uma chamada independente de instância que se aplica a todos os adaptadores, mas apenas ao Windows.
Exemplos
O exemplo de código Modificar a Ordem de Pesquisa de Sufixo DNS para Todos os Adaptadores de Rede VBScript configura um computador para usar dois sufixos DNS ao executar pesquisas de DNS.
O exemplo Habilitar Configurações de DHCP em um computador VBScript define todas as configurações normalmente necessárias para habilitar o DHCP em um computador.
O código do PowerShell a seguir define a ordem de pesquisa do sufixo DNS.
#First store the suffixes to set in a variable
$suffixes = 'microsoft.com', 'google.com', 'yahoo.com'
#Since this is a static method, get a class object and then call the method.
$class = [wmiclass]'Win32_NetworkAdapterConfiguration'
$class.SetDNSSuffixSearchOrder($suffixes)
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte |
Windows Vista |
| Servidor mínimo com suporte |
Windows Server 2008 |
| Namespace |
Root\CIMV2 |
| MOF |
|
| DLL |
|