Méthode SetGateways de la classe Win32_NetworkAdapterConfiguration

La méthode de classeSetGatewaysWMI spécifie une liste de passerelles pour le routage de 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 vers des passerelles où les paquets réseau sont routés.

GatewayCostMetric [in, facultatif]

Affecte 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 une valeur de 0 (zéro) pour une exécution réussie lorsqu’un redémarrage n’est pas obligatoire, 1 (un) pour une fin réussie lorsqu’un redémarrage est requis et toute autre valeur s’il existe une erreur. Pour plus d’informations sur les codes d’erreur, consultez Constantes d’erreur WMI ou WbemErrorEnum. Pour obtenir des valeurs HRESULT générales, consultez Codes d’erreur système.

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

0

Réussite de la saisie semi-automatique, 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 liée au nombre de trames/réseau

86

Type d’image non valide

87

Numéro de réseau non valide

88

Numéro de 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 d’informer le service

95

Impossible d’avertir le service DNS

96

Interface non configurable

97

Tous les baux DHCP ne peuvent pas ê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 Modifier les passerelles pour une carte réseau VBScript configure deux passerelles pour une carte réseau.

L’exemple Assign a Static IP Address VBScript 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