Win32_NetworkAdapterConfiguration クラスの SetGateways メソッド
SetGatewaysWMI クラス メソッドは、ネットワーク アダプターが接続されているサブネットとは異なるサブネットにパケットをルーティングするためのゲートウェイの一覧を指定します。
このトピックでは、マネージド オブジェクト形式 (MOF) 構文を使用します。 このメソッドの使用方法の詳細については、「メソッドの 呼び出し」を参照してください。
構文
uint32 SetGateways(
[in] string DefaultIPGateway[],
[in, optional] uint16 GatewayCostMetric[]
);
パラメーター
-
DefaultIPGateway [in]
-
ネットワーク パケットがルーティングされるゲートウェイへの IP アドレスの一覧。
-
GatewayCostMetric [in, optional]
-
1 から 9999 までの範囲の値を割り当てます。これは、最も高速で信頼性の高いルートの計算に使用されます。 このパラメーターの値は 、DefaultIPGateway パラメーターの値に対応しています。 ゲートウェイの既定値は 1 です。
戻り値
再起動が必要ない場合に正常に完了するには 0 (ゼロ)、再起動が必要な場合は正常に完了するために 1 (1)、エラーが発生した場合は他の値を返します。 エラー コードの詳細については、「 WMI エラー定数 」または 「WbemErrorEnum」を参照してください。 一般的な HRESULT 値については、「 システム エラー コード」を参照してください。
-
正常に完了し、再起動は必要ありません
-
0
-
正常に完了しました。再起動が必要です
-
1
-
このプラットフォームではサポートされていないメソッド
-
64
NIC が DHCP モードの場合、メソッドはサポートされていません。
-
不明なエラー
-
65
-
サブネット マスクが無効です
-
66
-
返されたインスタンスの処理中にエラーが発生しました
-
67
-
入力パラメーターが無効です
-
68
-
5 つ以上のゲートウェイが指定されている
-
69
-
無効な IP アドレス
-
70
-
ゲートウェイの IP アドレスが無効です
-
71
-
要求された情報のレジストリへのアクセス中にエラーが発生しました
-
72
-
無効なドメイン名
-
73
-
ホスト名が無効です
-
74
-
プライマリ/セカンダリ WINS サーバーが定義されていません
-
75
-
ファイルが無効です
-
76
-
システム パスが無効です
-
77
-
ファイルのコピーに失敗しました
-
78
-
セキュリティ パラメーターが無効です
-
79
-
TCP/IP サービスを構成できない
-
80
-
DHCP サービスを構成できない
-
81
-
DHCP リースを更新できない
-
82
-
DHCP リースを解放できない
-
83
-
アダプターで IP が有効になっていない
-
84
-
アダプターで IPX が有効になっていない
-
85
-
フレーム/ネットワーク番号の境界エラー
-
86
-
フレームの種類が無効です
-
87
-
ネットワーク番号が無効です
-
88
-
重複するネットワーク番号
-
89
-
パラメーターの範囲外
-
90
-
アクセスが拒否されました
-
91
-
メモリ不足
-
92
-
既に存在する
-
93
-
パス、ファイル、またはオブジェクトが見つかりません
-
94
-
サービスに通知できない
-
95
-
DNS サービスに通知できない
-
96
-
インターフェイスが構成できない
-
97
-
すべての DHCP リースをリリースまたは更新できない
-
98
-
アダプターで DHCP が有効になっていない
-
100
-
その他
-
101 4294967295
注釈
この方法は、ネットワーク インターフェイス カード (NIC) が静的 IP モードの場合にのみ機能します。
ゲートウェイをクリアするには、 EnableStatic で使用するのと同じ IP にゲートウェイを設定します。
例
「ネットワーク アダプター VBScript のゲートウェイを変更する」サンプルでは、ネットワーク アダプター用に 2 つのゲートウェイを構成します。
静的 IP アドレスの割り当て VBScript サンプルでは、コンピューターの IP アドレスとゲートウェイを設定します。
静的 IP を使用してドメイン PowerShell に参加するサンプルは、マシンの再構築に役立ちます。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント |
Windows Vista |
| サポートされている最小のサーバー |
Windows Server 2008 |
| 名前空間 |
Root\CIMV2 |
| MOF |
|
| [DLL] |
|