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	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