Méthode SetDNSSuffixSearchOrder de la classe Win32_NetworkAdapterConfiguration

La méthode statique de la classe WMISetDNSSuffixSearchOrder utilise un tableau d’éléments de chaîne pour définir l’ordre de recherche des suffixes.

Cette rubrique utilise la syntaxe MOF (Managed Object Format). Pour plus d’informations sur l’utilisation de cette méthode, consultez Appel d’une méthode.

Syntaxe

uint32 SetDNSSuffixSearchOrder(
  [in] string DNSDomainSuffixSearchOrder[]
);

Paramètres

DNSDomainSuffixSearchOrder [in]

Liste des suffixes de serveur à interroger pour les serveurs DNS. L’emplacement du Registre du suffixe DNS est HKEY_LOCAL_MACHINE\System\CurrentControlSet\Services\Tcpip| Nameserver

Exemple : « suffix1.company.com », « suffix2.company.com »

Valeur retournée

Retourne une valeur de 0 (zéro) pour une exécution réussie lorsqu’aucun redémarrage n’est requis, 1 (un) pour une exécution réussie lorsqu’un redémarrage est requis et un nombre différent en cas d’erreur. Pour plus d’informations sur les codes d’erreur, consultez Constantes d’erreur WMI ou WbemErrorEnum. Pour connaître les valeurs HRESULT générales, consultez Codes d’erreur système.

Achèvement réussi, aucun redémarrage requis

0

Réussite de l’exécution, aucun redémarrage n’est requis.

Achèvement réussi, redémarrage requis

1

Réussite de l’exécution, redémarrage requis.

Méthode non prise en charge sur cette plateforme

64

Méthode non prise en charge sur cette plateforme.

Échec inconnu

65

Échec inconnu.

Masque de sous-réseau non valide

66

Masque de sous-réseau non valide.

Une erreur s’est produite lors du traitement d’une instance retournée

67

Une erreur s’est produite lors du traitement d’un instance retourné.

Paramètre d’entrée non valide

68

Paramètre d'entrée non valide.

Plus de 5 passerelles spécifiées

69

Plus de cinq passerelles spécifiées.

Adresse IP non valide

70

Adresse IP non valide.

Adresse IP de la passerelle non valide

71

Adresse IP de la passerelle non valide.

Une erreur s’est produite lors de l’accès au Registre pour les informations demandées

72

Une erreur s’est produite lors de l’accès au Registre pour les informations demandées.

Nom de domaine non valide

73

Nom de domaine non valide.

Nom d’hôte non valide

74

Nom d’hôte non valide.

Aucun serveur WINS principal/secondaire défini

75

Aucun serveur WINS principal ou secondaire défini.

Fichier non valide

76

Fichier non valide.

Chemin d’accès système non valide

77

Chemin d’accès système non valide.

Échec de la copie de fichier

78

Échec de la copie de fichier.

Paramètre de sécurité non valide

79

Paramètre de sécurité non valide.

Impossible de configurer le service TCP/IP

80

Impossible de configurer le service TCP/IP.

Impossible de configurer le service DHCP

81

Impossible de configurer le service DHCP.

Impossible de renouveler le bail DHCP

82

Impossible de renouveler le bail DHCP.

Impossible de libérer le bail DHCP

83

Impossible de libérer le bail DHCP.

ADRESSE IP non activée sur l’adaptateur

84

IP non activée sur l’adaptateur.

IPX non activé sur l’adaptateur

85 %

IPX non activé sur l’adaptateur.

Erreur de limites de numéro de trame/réseau

86

Erreur de limites de trame ou de numéro de réseau.

Type de frame non valide

87

Type de frame non valide.

Numéro de réseau non valide

88

Numéro de réseau non valide.

Numéro de réseau en double

89

Numéro de réseau en double.

Paramètre hors limites

90

Paramètre hors limites.

Accès refusé

91

Accès refusé.

Mémoire insuffisante

92

Mémoire insuffisante.

Existe déjà

93

Existe déjà.

Chemin d’accès, fichier ou objet introuvable

94

Chemin, fichier ou objet introuvable.

Impossible de notifier le service

95

Impossible de notifier le service.

Impossible de notifier le service DNS

96

Impossible de notifier le service DNS.

Interface non configurable

97

Interface non configurable.

Tous les baux DHCP n’ont pas pu être libérés/renouvelés

98

Tous les baux DHCP ne sont pas libérés ou renouvelés.

DHCP non activé sur l’adaptateur

100

DHCP non activé sur l’adaptateur.

Autres

101 4294967295

Notes

Il s’agit d’un appel indépendant instance qui s’applique à tous les adaptateurs, mais uniquement pour Windows.

Exemples

L’exemple de code VBScript Modifier l’ordre de recherche de suffixes DNS pour toutes les cartes réseau configure un ordinateur pour qu’il utilise deux suffixes DNS lors de l’exécution de recherches DNS.

L’exemple Activer les paramètres DHCP sur un ordinateur VBScript configure tous les paramètres généralement requis pour activer DHCP sur un ordinateur.

Le code PowerShell suivant définit l’ordre de recherche du suffixe 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)

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows Vista
Serveur minimal pris en charge	Windows Server 2008
Espace de noms	Racine\CIMV2
MOF	CIMWin32.mof
DLL	CIMWin32.dll

Voir aussi

Classes matérielles du système informatique

Win32_NetworkAdapterConfiguration

Tâches WMI : Mise en réseau

Tâches WMI : Comptes et domaines

Prise en charge d’IPv6 et IPv4 dans WMI