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
CIMWin32.mof
[DLL]
CIMWin32.dll

こちらもご覧ください

コンピューター システム ハードウェア クラス

Win32_NetworkAdapterConfiguration

WMI タスク: ネットワーク

WMI タスク: アカウントとドメイン

WMI での IPv6 と IPv4 のサポート