Método EnableDNS de la clase Win32_NetworkAdapterConfiguration
El método estático de clase WMIEnableDNS habilita el sistema de nombres de dominio (DNS) para el servicio.
En este tema se usa la sintaxis de Managed Object Format (MOF). Para obtener más información sobre el uso de este método, vea Llamar a un método.
Sintaxis
uint32 EnableDNS(
[in, optional] string DNSHostName,
[in, optional] string DNSDomain,
[in, optional] string DNSServerSearchOrder[],
[in, optional] string DNSDomainSuffixSearchOrder[]
);
Parámetros
-
DNSHostName [in, optional]
-
Nombre del host DNS que este método habilita.
Ejemplo: "corpdns"
-
DNSDomain [in, opcional]
-
Representa un nombre de organización seguido de un punto y una extensión que indica el tipo de organización.
Ejemplo: "microsoft.com"
-
DNSServerSearchOrder [in, optional]
-
Lista de direcciones IP del servidor que se van a consultar para los servidores DNS.
-
DNSDomainSuffixSearchOrder [in, optional]
-
Sufijo de dominio DNS que se anexa a un nombre de host durante la resolución de nombres. Al resolver un nombre de dominio completo (FQDN) desde un nombre de solo host, el sistema anexa el nombre de dominio local. Si la resolución de nombres no se realiza correctamente, el sistema usa la lista de sufijos de dominio para crear FQDN adicionales en el orden indicado y, a continuación, consulta los servidores DNS para cada uno.
Valor devuelto
Devuelve un valor de 0 (cero) para una finalización correcta cuando no se requiere un reinicio, 1 (uno) para una finalización correcta cuando se requiere un reinicio y cualquier otro número si se produce un error. Para obtener más información sobre los códigos de error, vea Constantes de error de WMI o WbemErrorEnum. Para obtener valores HRESULT generales, consulte Códigos de error del sistema.
-
Finalización correcta, sin necesidad de reinicio
-
0
Finalización correcta, no es necesario reiniciar.
-
Finalización correcta, reinicio necesario
-
1
Finalización correcta, se requiere reiniciar.
-
No se admite el método en esta plataforma
-
64
No se admite el método en esta plataforma.
-
Error desconocido
-
65
Error desconocido.
-
Máscara de subred no válida
-
66
Máscara de subred no válida.
-
Error al procesar una instancia devuelta
-
67
Error al procesar una instancia de que se devolvió.
-
Parámetro de entrada no válido
-
68
El parámetro de entrada no es válido.
-
Más de 5 puertas de enlace especificadas
-
69
Más de cinco puertas de enlace especificadas.
-
Dirección IP no válida
-
70
Dirección IP no válida.
-
Dirección IP de puerta de enlace no válida
-
71
Dirección IP de puerta de enlace no válida.
-
Error al acceder al Registro para obtener la información solicitada.
-
72
Error al acceder al registro para obtener la información solicitada.
-
Nombre de dominio no válido
-
73
Nombre de dominio no válido.
-
Nombre de host no válido
-
74
Nombre de host no válido.
-
No se ha definido ningún servidor WINS principal o secundario
-
75
No se ha definido ningún servidor WINS principal o secundario.
-
Archivo no válido
-
76
Archivo no válido.
-
Ruta de acceso del sistema no válida
-
77
Ruta de acceso del sistema no válida.
-
Error de copia de archivos
-
78
Error en la copia de archivos.
-
Parámetro de seguridad no válido
-
79
Parámetro de seguridad no válido.
-
No se puede configurar el servicio TCP/IP
-
80
No se puede configurar el servicio TCP/IP.
-
No se puede configurar el servicio DHCP
-
81
No se puede configurar el servicio DHCP.
-
No se puede renovar la concesión dhcp
-
82
No se puede renovar la concesión dhcp.
-
No se puede liberar la concesión dhcp
-
83
No se puede liberar la concesión dhcp.
-
Ip no habilitada en el adaptador
-
84
Ip no habilitada en el adaptador.
-
IPX no habilitado en el adaptador
-
85
IPX no está habilitado en el adaptador.
-
Error de límites de número de red o marco
-
86
Error de límites de número de red o marco.
-
Tipo de marco no válido
-
87
Tipo de marco no válido.
-
Número de red no válido
-
88
Número de red no válido.
-
Número de red duplicado
-
89
Número de red duplicado.
-
Parámetro fuera de los límites
-
90
Parámetro fuera de los límites.
-
Acceso denegado
-
91
Acceso denegado.
-
Memoria insuficiente
-
92
Memoria insuficiente
-
Ya existe
-
93
Ya existe.
-
Ruta de acceso, archivo u objeto no encontrado
-
94
Ruta de acceso, archivo u objeto no encontrado.
-
No se puede notificar al servicio
-
95
No se puede notificar al servicio.
-
No se puede notificar al servicio DNS
-
96
No se puede notificar al servicio DNS.
-
Interfaz no configurable
-
97
Interfaz no configurable.
-
No todas las concesiones DHCP se podrían liberar o renovar
-
98
No todas las concesiones DHCP se pueden liberar o renovar.
-
DHCP no habilitado en el adaptador
-
100
DHCP no habilitado en el adaptador.
-
Otros
-
101 4294967295
Ejemplos
El ejemplo de código siguiente, tomado del ejemplo de código Enable DNS on All Network Adapters VBScript (Habilitar DNS en todos los adaptadores de red ) de la Galería de TechNet, habilita DNS para todos los adaptadores de red de un equipo.
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 | Value |
|---|---|
| Cliente mínimo compatible |
Windows Vista |
| Servidor mínimo compatible |
Windows Server 2008 |
| Espacio de nombres |
Root\CIMV2 |
| MOF |
|
| Archivo DLL |
|