Win32_NetworkAdapterConfiguration クラスの ReleaseDHCPLease メソッド
ReleaseDHCPLeaseWMI クラス メソッドは、特定の DHCP 対応ネットワーク アダプターにバインドされている IP アドレスを解放します。
このトピックでは、マネージド オブジェクト形式 (MOF) 構文を使用します。 このメソッドの使用方法の詳細については、「メソッドの 呼び出し」を参照してください。
構文
uint32 ReleaseDHCPLease();
パラメーター
このメソッドにはパラメーターはありません。
戻り値
再起動が必要ない場合に正常に完了するには 0 (ゼロ) の値を返し、再起動が必要な場合は正常に完了するには 1 を返し、エラーがある場合は別の数値を返します。 エラー コードの詳細については、「 WMI エラー定数 」または 「WbemErrorEnum」を参照してください。 一般的な HRESULT 値については、「 システム エラー コード」を参照してください。
-
正常に完了し、再起動は必要ありません
-
0
正常に完了しました。再起動は必要ありません。
-
正常に完了し、再起動が必要です
-
1
正常に完了しました。再起動が必要です。
-
このプラットフォームではサポートされていないメソッド
-
64
メソッドは、このプラットフォームではサポートされていません。
-
不明なエラー
-
65
不明なエラー。
-
サブネット マスクが無効です
-
66
サブネット マスクが無効です。
-
返されたインスタンスの処理中にエラーが発生しました
-
67
返されたインスタンスの処理中にエラーが発生しました。
-
入力パラメーターが無効です
-
68
入力パラメーターが無効です。
-
5 つ以上のゲートウェイが指定されています
-
69
5 つ以上のゲートウェイが指定されています。
-
IP アドレスが無効です
-
70
IP アドレスが無効です。
-
無効なゲートウェイ IP アドレス
-
71
ゲートウェイ IP アドレスが無効です。
-
要求された情報のレジストリへのアクセス中にエラーが発生しました
-
72
要求された情報のレジストリへのアクセス中にエラーが発生しました。
-
無効なドメイン名
-
73
ドメイン名が無効です。
-
ホスト名が無効です
-
74
ホスト名が無効です。
-
プライマリ/セカンダリ WINS サーバーが定義されていません
-
75
プライマリまたはセカンダリ WINS サーバーが定義されていません。
-
無効なファイル
-
76
無効なファイルです。
-
無効なシステム パス
-
77
システム パスが無効です。
-
ファイルのコピーに失敗しました
-
78
ファイルのコピーに失敗しました。
-
無効なセキュリティ パラメーター
-
79
セキュリティ パラメーターが無効です。
-
TCP/IP サービスを構成できない
-
80
TCP/IP サービスを構成できません。
-
DHCP サービスを構成できない
-
81
DHCP サービスを構成できません。
-
DHCP リースを更新できない
-
82
DHCP リースを更新できません。
-
DHCP リースを解放できない
-
83
DHCP リースを解放できません。
-
アダプターで IP が有効になっていない
-
84
アダプターで IP が有効になっていません。
-
アダプターで IPX が有効になっていない
-
85
アダプターで IPX が有効になっていません。
-
フレーム/ネットワーク番号の境界エラー
-
86
フレームまたはネットワーク番号の境界エラー。
-
フレームの種類が無効です
-
87
フレームの種類が無効です。
-
ネットワーク番号が無効です
-
88
ネットワーク番号が無効です。
-
重複するネットワーク番号
-
89
重複するネットワーク番号。
-
パラメーターの範囲外
-
90
パラメーターが範囲外です。
-
アクセスが拒否されました
-
91
アクセスが拒否されました。
-
メモリ不足
-
92
メモリが不足しています。
-
既に存在する
-
93
既に存在します。
-
パス、ファイル、またはオブジェクトが見つかりません
-
94
パス、ファイル、またはオブジェクトが見つかりません。
-
サービスに通知できない
-
95
サービスに通知できません。
-
DNS サービスに通知できない
-
96
DNS サービスに通知できません。
-
インターフェイスが構成できない
-
97
インターフェイスは構成できません。
-
すべての DHCP リースをリリースまたは更新できない
-
98
すべての DHCP リースを解放または更新できるわけではありません。
-
アダプターで DHCP が有効になっていない
-
100
アダプターで DHCP が有効になっていません。
-
その他
-
101 4294967295
解説
注意事項
ローカル コンピューター システムで DHCP が有効になっている場合、 オプションは、この特定のネットワーク アダプターで TCP/IP を無効にします。 ターゲット・システム (別の TCP/IP バインド・ネットワーク・アダプター) への代替パスがない限り、すべての TCP/IP 通信は失われます。
例
TechNet ギャラリーの PowerShell PowerShell を使用した IP Adresses のリリース更新 の例では、 ReleaseDHCPLease を使用して IP アドレスを解放および更新します。
次の VBScript コードは、コンピューター上のすべての TCP/IP バインド ネットワーク アダプターの DHCP リースを解放します。
On Error Resume Next
strComputer = "."
Set objWMIService = GetObject("winmgmts:" _
& "{impersonationLevel=impersonate}!\\" & strComputer & "\root\cimv2")
Set colNetCards = objWMIService.ExecQuery _
("Select * From Win32_NetworkAdapterConfiguration Where IPEnabled = True")
For Each objNetCard in colNetCards
objNetCard.ReleaseDHCPLease()
Next
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント |
Windows Vista |
| サポートされている最小のサーバー |
Windows Server 2008 |
| 名前空間 |
Root\CIMV2 |
| MOF |
|
| [DLL] |
|