Metodo SetDNSSuffixSearchOrder della classe Win32_NetworkAdapterConfiguration
Il metodo statico della classe WMI SetDNSSuffixSearchOrderusa una matrice di elementi stringa per impostare l'ordine di ricerca del suffisso.
In questo argomento viene utilizzata la sintassi MOF (Managed Object Format). Per altre informazioni sull'uso di questo metodo, vedere Chiamata di un metodo.
Sintassi
uint32 SetDNSSuffixSearchOrder(
[in] string DNSDomainSuffixSearchOrder[]
);
Parametri
-
DNSDomainSuffixSearchOrder [in]
-
Elenco di suffissi del server per eseguire query per i server DNS. Il percorso del Registro di sistema del suffisso DNS è HKEY_LOCAL_MACHINE\System\CurrentControlSet\Services\Tcpip|NameServer
Esempio: "suffix1.company.com", "suffix2.company.com"
Valore restituito
Restituisce un valore pari a 0 (zero) per un completamento riuscito quando non è necessario alcun riavvio, 1 (uno) per un completamento corretto quando è necessario un riavvio e un numero diverso se si verifica un errore. Per altre informazioni sui codici di errore, vedere Costanti errore WMI o WbemErrorEnum. Per i valori HRESULT generali, vedere Codici di errore di sistema.
-
Completamento completato, nessun riavvio necessario
-
0
Completamento completato, nessun riavvio necessario.
-
Completamento completato, riavvio richiesto
-
1
Completamento completato, riavvio richiesto.
-
Metodo non supportato in questa piattaforma
-
64
Metodo non supportato in questa piattaforma.
-
Errore sconosciuto
-
65
Errore sconosciuto.
-
Subnet mask non valida
-
66
Subnet mask non valida.
-
Errore durante l'elaborazione di un'istanza restituita
-
67
Errore durante l'elaborazione di un'istanza restituita.
-
Parametro di input non valido
-
68
Parametro di input non valido.
-
Più di 5 gateway specificati
-
69
Più di cinque gateway specificati.
-
Indirizzo IP non valido
-
70
Indirizzo IP non valido.
-
Indirizzo IP del gateway non valido
-
71
Indirizzo IP del gateway non valido.
-
Errore durante l'accesso al Registro di sistema per le informazioni richieste
-
72
Errore durante l'accesso al Registro di sistema per le informazioni richieste.
-
Nome di dominio non valido
-
73
Nome di dominio non valido.
-
Nome host non valido
-
74
Nome host non valido.
-
Nessun server WINS primario/secondario definito
-
75
Nessun server WINS primario o secondario definito.
-
File non valido
-
76
File non valido.
-
Percorso di sistema non valido
-
77
Percorso di sistema non valido.
-
Copia file non riuscita
-
78
Copia file non riuscita.
-
Parametro di sicurezza non valido
-
79
Parametro di sicurezza non valido.
-
Impossibile configurare il servizio TCP/IP
-
80
Impossibile configurare il servizio TCP/IP.
-
Impossibile configurare il servizio DHCP
-
81
Impossibile configurare il servizio DHCP.
-
Non è possibile rinnovare il lease DHCP
-
82
Impossibile rinnovare il lease DHCP.
-
Non è possibile rilasciare il lease DHCP
-
83
Impossibile rilasciare il lease DHCP.
-
IP non abilitato nell'adapter
-
84
IP non abilitato nella scheda.
-
IPX non abilitato nella scheda
-
85
IPX non abilitato nella scheda.
-
Errore di limiti di frame/numero di rete
-
86
Errore di limiti di frame o numero di rete.
-
Tipo di frame non valido
-
87
Tipo di frame non valido.
-
Numero di rete non valido
-
88
Numero di rete non valido.
-
Numero di rete duplicato
-
89
Numero di rete duplicato.
-
Parametro fuori dai limiti
-
90
Parametro fuori dai limiti.
-
Accesso negato
-
91
Accesso negato.
-
Memoria insufficiente
-
92
Memoria esaurita.
-
Esiste già
-
93
Esiste già.
-
Percorso, file o oggetto non trovato
-
94
Percorso, file o oggetto non trovato.
-
Impossibile inviare una notifica al servizio
-
95
Impossibile inviare una notifica al servizio.
-
Impossibile inviare una notifica al servizio DNS
-
96
Impossibile inviare una notifica al servizio DNS.
-
Interfaccia non configurabile
-
97
Interfaccia non configurabile.
-
Non tutti i lease DHCP potrebbero essere rilasciati/rinnovati
-
98
Non tutti i lease DHCP vengono rilasciati o rinnovati.
-
DHCP non abilitato per l'adapter
-
100
DHCP non abilitato nella scheda.
-
Altri
-
101 4294967295
Osservazioni:
Si tratta di una chiamata indipendente dall'istanza che si applica a tutte le schede, ma solo per Windows.
Esempi
Il codice di PowerShell seguente imposta l'ordine di ricerca del suffisso 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)
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato |
Windows Vista |
| Server minimo supportato |
Windows Server 2008 |
| Spazio dei nomi |
Root\CIMV2 |
| MOF |
|
| DLL |
|