Win32_NetworkAdapterConfiguration クラスの SetDNSSuffixSearchOrder メソッド
SetDNSSuffixSearchOrderWMI クラスの静的メソッドは、文字列要素の配列を使用してサフィックスの検索順序を設定します。
このトピックでは、マネージド オブジェクト形式 (MOF) 構文を使用します。 このメソッドの使用方法の詳細については、「メソッドの 呼び出し」を参照してください。
構文
uint32 SetDNSSuffixSearchOrder(
[in] string DNSDomainSuffixSearchOrder[]
);
パラメーター
-
DNSDomainSuffixSearchOrder [in]
-
DNS サーバーに対してクエリを実行するサーバー サフィックスの一覧。 DNS サフィックスのレジストリの場所は 、\System\CurrentControlSet\Services\Tcpip HKEY_LOCAL_MACHINEです。ネームサーバ
例: "suffix1.company.com"、"suffix2.company.com"
戻り値
再起動が必要ない場合に正常に完了するには 0 (ゼロ) の値を返し、再起動が必要な場合は 1 (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 サーバーまたはセカンダリ 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
注釈
これはインスタンスに依存しない呼び出しであり、Windows でのみのすべてのアダプターに適用されます。
例
すべてのネットワーク アダプターの DNS サフィックス検索順序の変更 VBScript コード サンプルでは、DNS 検索の実行時に 2 つの DNS サフィックスを使用するようにコンピューターを構成します。
コンピューターでの DHCP 設定の有効化 VBScript サンプルでは、コンピューターで DHCP を有効にするために通常必要なすべての設定を構成します。
次の PowerShell コードは、DNS サフィックスの検索順序を設定します。
#First store the suffixes to set in a variable
$suffixes = 'microsoft.com', 'google.com', 'yahoo.com'
#Since this is a static method, get a class object and then call the method.
$class = [wmiclass]'Win32_NetworkAdapterConfiguration'
$class.SetDNSSuffixSearchOrder($suffixes)
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント |
Windows Vista |
| サポートされている最小のサーバー |
Windows Server 2008 |
| 名前空間 |
Root\CIMV2 |
| MOF |
|
| [DLL] |
|