Méthode EnableStatic de la classe Win32_NetworkAdapterConfiguration

La méthode de classe WMIEnableStatic active l’adressage TCP/IP statique pour la carte réseau cible. Par conséquent, DHCP pour cette carte réseau est désactivé.

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 EnableStatic(
  [in] string IPAddress[],
  [in] string SubnetMask[]
);

Paramètres

ADRESSE IP [in]

Répertorie toutes les adresses IP statiques de la carte réseau actuelle.

Exemple : 155.34.22.0.

SubnetMask [in]

Masques de sous-réseau qui complètent les valeurs du paramètre IPAddress .

Exemple : 255.255.0.0.

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 tout autre nombre 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. Pour plus d'informations, consultez la section Notes.

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 réseau en double

89

Numéro 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 d’accès, 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 n’ont pas pu être libérés ou renouvelés.

DHCP non activé sur l’adaptateur

100

DHCP non activé sur l’adaptateur.

2147786788

Verrou d’écriture non activé. Pour plus d’informations, consultez INetCfgLock::AcquireWriteLock.

Autres

101 4294967295

Notes

Lorsque vous utilisez EnableStatic pour modifier l’adresse IP de l’ordinateur distant, tout en étant connecté via cette carte, vous risquez de perdre la connexion à l’ordinateur distant et de recevoir un message d’erreur RPC non disponible. (les paramètres sont toutefois modifiés). Pour éviter ce scénario, envisagez de modifier la passerelle et/ou les paramètres DNS avant de définir l’adresse IP de l’adaptateur.

Lorsque vous utilisez EnableStatic pour donner à une carte une configuration IP statique, la fonction retourne un « 81 - Impossible de configurer le service DHCP » si l’adaptateur est déjà configuré avec une adresse statique. Toutefois, la fonction réussit toujours à définir avec la nouvelle opération.

Exemples

L’adresse IP statique, puis la jointure à un exemple de code PowerShell de domaine, sur TechNet Gallery, utilise EnableStatic pour ajouter une adresse IP statique à un ordinateur local.

L’exemple de code VBScript Attribuer une adresse IP statique , sur TechNet Gallery, utilise EnableStatic pour définir l’adresse IP d’un ordinateur.

L’exemple VBScript suivant montre comment désactiver l’utilisation de DHCP sur un instance de Win32_NetworkAdapterConfiguration. Dans ce cas, nous spécifions l’adaptateur avec un index de 0. L’index correct doit être sélectionné parmi Win32_NetworkAdapter instances pour d’autres interfaces.

Set Adapter = GetObject("winmgmts:Win32_NetworkAdapterConfiguration=1")

ipaddr = Array("1.1.1.1")
subnet = Array("255.255.255.0")


RetVal = Adapter.EnableStatic(ipaddr,subnet)

if RetVal = 0 then 
 WScript.Echo "DHCP disabled, using static IP address"
else 
 WScript.Echo "DHCP disable failed"
end if

L’exemple Perl suivant montre comment désactiver l’utilisation de DHCP sur un instance de Win32_NetworkAdapterConfiguration. Dans ce cas, nous spécifions l’adaptateur avec un index de 0. L’index correct doit être sélectionné parmi Win32_NetworkAdapter instances pour d’autres interfaces.

use strict;
use Win32::OLE;

my ($Adapter, @ipaddr, @subnet, $RetVal);  
eval { $Adapter = 
 Win32::OLE->GetObject("winmgmts:{impersonationLevel=impersonate}!\\\\.\\root\\cimv2:Win32_NetworkAdapterConfiguration.Index=\"0\""); };

unless ($@) 
{
 push @ipaddr, "192.168.144.107";
 push @subnet, "255.255.255.0";

 $RetVal = $Adapter->EnableStatic(\@ipaddr, \@subnet);

 if ($RetVal == 0) 
 {
  print "\nDHCP disabled, using static IP address\n";
 }
 else 
 {
  print "\nDHCP disable failed\n";
 }
}
else
{
 print STDERR "\n", Win32::OLE->LastError, "\n";
}

Spécifications

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