Win32_ComputerSystem クラスの JoinDomainOrWorkgroup メソッド

[アーティクル]
06/12/2023

JoinDomainOrWorkgroup メソッドは、コンピューターシステムをドメインまたはワークグループに参加させます。

このトピックでは、マネージドオブジェクト形式 (MOF) 構文を使用します。このメソッドの使用方法の詳細については、「メソッドの呼び出し」を参照してください。

構文

uint32 JoinDomainOrWorkgroup(
  [in] string Name,
  [in] string Password,
  [in] string UserName,
  [in] string AccountOU,
  [in] uint32 FJoinOptions = 
);

パラメーター

Name [in]

参加するドメインまたはワークグループを指定します。 NULL にすることはできません。

パスワード [入力]

UserName パラメーターにアカウント名が指定されている場合、Password パラメーターは、ドメインコントローラーへの接続時に使用するパスワードを指す必要があります。それ以外の場合、このパラメーターは NULL である必要があります。

UserName [in]

ドメインコントローラーへの接続時に使用するアカウント名を指定する 、null で終わる定数文字列へのポインター。ドメイン NetBIOS 名とユーザーアカウント (Domain\user など) を指定する必要があります。このパラメーターが NULL の場合は、呼び出し元情報が使用されます。

ユーザープリンシパル名 (UPPED) は、user@domainフォームでも使用できます。

AccountOU [in]

コンピューターアカウントの組織単位 (OU) の RFC 1779 形式名を含む、null で終わる定数文字列へのポインターを指定します。このパラメーターを指定する場合、文字列には完全なパスが含まれている必要があります。それ以外の場合は Accent を NULL にする必要があります。

例: "OU=testOU; DC=domain; DC=Domain; DC=com"

FJoinOptions [in]

結合オプションを定義する一連のビットフラグ。

(0)

既定値。結合オプションはありません。

NETSETUP_JOIN_DOMAIN (0x00000001)

コンピューターをドメインに参加させます。この値を指定しない場合は、コンピューターをワークグループに参加させます。

NETSETUP_ACCT_CREATE (0x00000002)

ドメインにアカウントを作成します。

NETSETUP_WIN9X_UPGRADE (0x00000010)

結合操作は、アップグレードの一環として実行されています。

NETSETUP_DOMAIN_JOIN_IF_JOINED (0x00000020)

コンピューターが既にドメインに参加している場合でも、新しいドメインへの参加を許可します。

NETSETUP_JOIN_UNSECURE (0x00000040)

セキュリティで保護されていない参加を実行します。

このオプションは、ドメインユーザーの資格情報を使用して認証することなく、事前に作成されたアカウントにドメイン参加を要求します。このオプションは、 NETSETUP_MACHINE_PWD_PASSED オプションと組み合わせて使用できます。この場合、[ パスワード] は、事前に作成されたコンピューターアカウントのパスワードです。

SP1 および Windows Server 2008 を使用する Windows Vista より前では、セキュリティで保護されていない参加がドメインコントローラーに対して認証されませんでした。すべての通信は、null (認証されていない) セッションを使用して実行されました。 SP1 および Windows Server 2008 の Windows Vista 以降では、コンピューターアカウント名とパスワードを使用してドメインコントローラーに対する認証が行われます。

NETSETUP_MACHINE_PWD_PASSED (0x00000080)

Password パラメーターで、ユーザーパスワードではなくローカルコンピューターアカウントのパスワードを指定することを示します。このフラグは、セキュリティで保護されていない結合に対してのみ有効です。これは、NETSETUP_JOIN_UNSECURE フラグを設定することによっても指定する必要があります。

このフラグを設定した場合、参加操作が成功すると、その値が有効なマシンパスワードである場合、マシンパスワードは Password の値に設定されます。

NETSETUP_DEFER_SPN_SET (0x00000100)

この時点で、コンピューターオブジェクトのサービスプリンシパル名 (SPN) と DnsHostName プロパティを更新しないことを示します。

通常、これらのプロパティは結合操作中に更新されます。代わりに、これらのプロパティは、 Rename メソッドの 後続の呼び出し中に更新する必要があります。これらのプロパティは、名前の変更操作中に常に更新されます。

NETSETUP_JOIN_DC_ACCOUNT (0x00000200)

既存のアカウントがドメインコントローラーである場合は、ドメイン参加を許可します。

注意

このフラグは、Windows Vista 以降でサポートされています。

NETSETUP_AMBIGUOUS_DC (0x00001000)

ドメインに参加するときは、レジストリで優先ドメインコントローラーを設定しないでください。

注意