次の方法で共有

Win32_NetworkAdapterConfiguration クラスの EnableDNS メソッド

  • [アーティクル]

EnableDNSWMI クラスの静的メソッドを使用すると、サービスのドメイン ネーム システム (DNS) が有効になります。

このトピックでは、Managed Object Format (MOF) 構文を使用します。 このメソッドの使用方法の詳細については、「メソッドの 呼び出し」を参照してください。

構文

uint32 EnableDNS(
  [in, optional] string DNSHostName,
  [in, optional] string DNSDomain,
  [in, optional] string DNSServerSearchOrder[],
  [in, optional] string DNSDomainSuffixSearchOrder[]
);

パラメーター

DNSHostName [in, optional]

このメソッドで有効にする DNS ホストの名前。

例: "corpdns"

DNSDomain [in, optional]

organization名の後にピリオドと、organizationの種類を示す拡張子を表します。

例: "microsoft.com"

DNSServerSearchOrder [in, optional]

DNS サーバーに対してクエリを実行するサーバー IP アドレスの一覧。

DNSDomainSuffixSearchOrder [in, optional]

名前解決中にホスト名に追加される DNS ドメイン サフィックス。 ホスト専用名から完全修飾ドメイン名 (FQDN) を解決すると、システムによってローカル ドメイン名が追加されます。 名前解決が成功しなかった場合、システムはドメイン サフィックス リストを使用して、一覧表示されている順序で追加の FQDN を作成し、DNS サーバーごとにクエリを実行します。

戻り値

再起動が必要ない場合に正常に完了するには 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 サーバーが定義されていません。

無効なファイル

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

例

次のコード サンプルは、TechNet ギャラリー のすべてのネットワーク アダプターで DNS を有効にする VBScript コード サンプルから取得し、コンピューター上のすべてのネットワーク アダプターの DNS を有効にします。

On Error Resume Next 
 
strComputer = "." 
Set objWMIService = GetObject("winmgmts:" _ 
    & "{impersonationLevel=impersonate}!\\" & strComputer & "\root\cimv2") 
 
Set objNetworkSettings = objWMIService.Get("Win32_NetworkAdapterConfiguration") 
strHostName = "fabrikam1" 
arrDNSSuffixes = Array("hr.fabrikam.com", "research.fabrikam.com") 
objNetworkSettings.EnableDNS strHostName, , , arrDNSSuffixes

要件

要件 値
サポートされている最小のクライアント
 Windows Vista
サポートされている最小のサーバー
 Windows Server 2008
名前空間
 Root\CIMV2
MOF
CIMWin32.mof
[DLL]
CIMWin32.dll

こちらもご覧ください

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

Win32_NetworkAdapterConfiguration

WMI タスク: ネットワーク

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

WMI での IPv6 と IPv4 のサポート