Méthode SetGateways de la classe Win32_NetworkAdapterConfiguration
La méthode de classe WMISetGateways spécifie une liste de passerelles pour le routage des paquets vers un sous-réseau différent du sous-réseau auquel la carte réseau est connectée.
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 SetGateways(
[in] string DefaultIPGateway[],
[in, optional] uint16 GatewayCostMetric[]
);
Paramètres
-
DefaultIPGateway [in]
-
Liste des adresses IP des passerelles où les paquets réseau sont routés.
-
GatewayCostMetric [in, facultatif]
-
Attribue une valeur comprise entre 1 et 9999, qui est utilisée pour calculer les itinéraires les plus rapides et les plus fiables. Les valeurs de ce paramètre correspondent aux valeurs du paramètre DefaultIPGateway . La valeur par défaut d’une passerelle est 1.
Valeur retournée
Retourne la valeur 0 (zéro) pour une exécution réussie lorsqu’un redémarrage n’est pas requis, 1 (un) pour une exécution réussie lorsqu’un redémarrage est requis et toute autre valeur 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
-
Achèvement réussi, redémarrage requis
-
1
-
Méthode non prise en charge sur cette plateforme
-
64
Méthode non prise en charge lorsque la carte réseau est en mode DHCP.
-
Échec inconnu
-
65
-
Masque de sous-réseau non valide
-
66
-
Une erreur s’est produite lors du traitement d’une instance retournée
-
67
-
Paramètre d’entrée non valide
-
68
-
Plus de 5 passerelles spécifiées
-
69
-
Adresse IP non valide
-
70
-
Adresse IP de passerelle non valide
-
71
-
Une erreur s’est produite lors de l’accès au Registre pour les informations demandées
-
72
-
Nom de domaine non valide
-
73
-
Nom d’hôte non valide
-
74
-
Aucun serveur WINS principal/secondaire défini
-
75
-
Fichier non valide
-
76
-
Chemin d’accès système non valide
-
77
-
Échec de la copie de fichier
-
78
-
Paramètre de sécurité non valide
-
79
-
Impossible de configurer le service TCP/IP
-
80
-
Impossible de configurer le service DHCP
-
81
-
Impossible de renouveler le bail DHCP
-
82
-
Impossible de libérer le bail DHCP
-
83
-
Adresse IP non activée sur l’adaptateur
-
84
-
IPX non activé sur l’adaptateur
-
85 %
-
Erreur de limites de numéro de trame/réseau
-
86
-
Type de trame non valide
-
87
-
Numéro de réseau non valide
-
88
-
Numéro réseau en double
-
89
-
Paramètre hors limites
-
90
-
Accès refusé
-
91
-
Mémoire insuffisante
-
92
-
Existe déjà
-
93
-
Chemin d’accès, fichier ou objet introuvable
-
94
-
Impossible de notifier le service
-
95
-
Impossible de notifier le service DNS
-
96
-
Interface non configurable
-
97
-
Tous les baux DHCP n’ont pas pu être libérés/renouvelés
-
98
-
DHCP non activé sur l’adaptateur
-
100
-
Autres
-
101 4294967295
Notes
Cette méthode fonctionne uniquement lorsque la carte d’interface réseau (NIC) est en mode IP statique.
Pour effacer la passerelle, définissez votre passerelle sur la même adresse IP que celle que vous utilisez sur EnableStatic.
Exemples
L’exemple VBScript Modifier les passerelles pour une carte réseau configure deux passerelles pour une carte réseau.
L’exemple VBScript Attribuer une adresse IP statique définit l’adresse IP et la passerelle d’un ordinateur.
L’adresse IP statique, puis la jointure à un exemple powerShell de domaine, facilite la reconstruction des machines.
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 |
|
| DLL |
|