NETSETUP_PROVISIONING_PARAMS 構造体 (lmjoin.h)

  • [アーティクル]

NETSETUP_PROVISIONING_PARAMS構造体には、NetCreateProvisionPackage 関数を使用してプロビジョニング パッケージを作成するときに使用される情報が含まれています。

構文

typedef struct _NETSETUP_PROVISIONING_PARAMS {
  DWORD   dwVersion;
  LPCWSTR lpDomain;
  LPCWSTR lpHostName;
  LPCWSTR lpMachineAccountOU;
  LPCWSTR lpDcName;
  DWORD   dwProvisionOptions;
  LPCWSTR *aCertTemplateNames;
  DWORD   cCertTemplateNames;
  LPCWSTR *aMachinePolicyNames;
  DWORD   cMachinePolicyNames;
  LPCWSTR *aMachinePolicyPaths;
  DWORD   cMachinePolicyPaths;
  LPWSTR  lpNetbiosName;
  LPWSTR  lpSiteName;
  LPWSTR  lpPrimaryDNSDomain;
} NETSETUP_PROVISIONING_PARAMS, *PNETSETUP_PROVISIONING_PARAMS;

メンバー

dwVersion

プロビジョニング パッケージ内の Windows のバージョン。 このパラメーターでは、 Lmjoin.h ヘッダー ファイルで定義されている次の値を使用する必要があります。

値 意味
NETSETUP_PROVISIONING_PARAMS_CURRENT_VERSION
0x00000001
 このパッケージのバージョンはWindows Server 2012。

lpDomain

コンピューター アカウントが作成されるドメインの名前を指定する NULL で終わる文字列へのポインター。

lpHostName

コンピューター アカウント属性 sAMAccountName の派生元となるコンピューターの短い名前を指定する NULL で終わる文字列へのポインター。'$' を追加します。 このパラメーターには、有効な DNS または NetBIOS コンピューター名を含める必要があります。

lpMachineAccountOU

コンピューター アカウントが作成される組織単位 (OU) の RFC 1779 形式名を含む NULL で終わる文字列への省略可能なポインター。 このパラメーターを指定する場合、文字列には完全なパス (OU=testOU,DC=domain,DC=Domain,DC=com など) が含まれている必要があります。 それ以外の場合、このパラメーターは NULL である必要があります。

このパラメーターが NULL の場合、既知のコンピューター オブジェクト コンテナーがドメインで発行されたものとして使用されます。

lpDcName

ターゲットにするドメイン コントローラーの名前を含む NULL で終わる文字列への省略可能なポインター。

dwProvisionOptions

プロビジョニング オプションを定義するビット フラグのセット。 このパラメーターには、 Lmjoin.h ヘッダー ファイルで定義されている次の値のうち 1 つ以上を指定できます。

値 意味
NETSETUP_PROVISION_DOWNLEVEL_PRIV_SUPPORT
0x00000001
 呼び出し元に特権によるアカウントの作成が必要な場合、このオプションでは、以前のバージョンの Windows で実行されているドメイン コントローラーとの相互運用性を可能にするアカウント作成関数を使用して、失敗時に再試行が発生します。

downlevel 特権のサポートを使用する場合、 lpMachineAccountOU はサポートされません。
NETSETUP_PROVISION_REUSE_ACCOUNT
0x00000002
 名前付きアカウントが既に存在する場合は、既存のアカウントの再利用が試行されます。

このオプションでは、この操作 (ドメイン管理者またはオブジェクト所有者) に十分な資格情報が必要です。
NETSETUP_PROVISION_USE_DEFAULT_PASSWORD
0x00000004
 コンピューター名の既定のコンピューター アカウント パスワードを小文字で使用します。 これは主に、事前に作成されたアカウントで通常この既定のパスワードが使用される、以前のセキュリティ保護されていない参加モデルをサポートするためです。
NETSETUP_PROVISION_SKIP_ACCOUNT_SEARCH
0x00000008
 ドメイン内のドメイン コントローラーでアカウントを検索しないでください。 このオプションを使用すると、操作が高速になりますが、呼び出し元が同じ名前のアカウントが最近作成されていないことが確実な場合にのみ使用する必要があります。

このオプションは、 lpDcName パラメーターが指定されている場合にのみ有効です。 前提条件が満たされると、このオプションを使用すると、バッチ処理などのシナリオに役立つプロビジョニングを高速化する必要があります。
NETSETUP_PROVISION_ROOT_CA_CERTS
0x00000010
 このオプションは、ローカル コンピューター上のすべてのルート証明機関証明書を取得し、プロビジョニング パッケージに追加します。
メモこのフラグは、Windows 8、Windows Server 2012、以降の NetCreateProvisioningPackage 関数でのみサポートされます。
 

aCertTemplateNames

NULL で終わる証明書テンプレート名の配列へのポインター。

cCertTemplateNames

aCertTemplateNames が NULL でない場合、このメンバーは配列内の項目数の明示的なカウントを提供します。

aMachinePolicyNames

NULL で終わるマシン ポリシー名の配列へのポインター。

cMachinePolicyNames

aMachinePolicyNames が NULL でない場合、このメンバーは配列内の項目数の明示的なカウントを提供します。

aMachinePolicyPaths

文字列の配列へのポインター。 各配列要素は NULL で終わる文字列であり、レジストリ ポリシー ファイル形式のファイルへの完全または部分的なパスを指定します。 レジストリ ポリシー ファイル形式の詳細については、「レジストリ ポリシー ファイル形式」を参照してください。

このパスは、リモート サーバー上の UNC パスである可能性があります。

cMachinePolicyPaths

aMachinePolicyPaths が NULL でない場合、このメンバーは配列内の項目数の明示的なカウントを提供します。

lpNetbiosName

TBD

lpSiteName

TBD

lpPrimaryDNSDomain

TBD

注釈

NETSETUP_PROVISIONING_PARAMS構造体は、オフライン結合操作のWindows 8とWindows Server 2012でサポートされている NetCreateProvisioningPackage 関数のフラグを提供します。

ドメイン参加に加えて、プロビジョニング パッケージは証明書とポリシーをコンピューターに提供できます。 プロビジョニング パッケージは、次の 4 つの方法で使用できます。

  • ドメイン参加
  • 証明書のドメイン参加とインストール
  • ポリシーのドメイン参加とインストール
  • 証明書とポリシーのドメイン参加とインストール

証明書をパッケージに追加する必要がある場合、この構造体は、NULL で終わる証明書テンプレート名の配列として、aCertTemplateNames メンバーを提供します。 aCertTemplateNames メンバーには、配列内の項目数の明示的な数を指定するために cCertTemplateNames メンバーが必要です。

ポリシーを追加するには、2 つの異なる方法があります。 1 つまたは両方のメソッドを使用できます。

  • ポリシー名 - NULL で終わるポリシー名の配列は、 aMachinePolicyNames メンバーに指定されます。 実行時に、ポリシー名が AD のポリシー名にマップされ、エンタープライズ空間のポリシーを表す GUID が取得されます。 aMachinePolicyNames メンバーには、配列内の項目数の明示的な数を指定するために cMachinePolicyNames メンバーが必要です。
  • ポリシー パス - レジストリ ポリシー ファイル形式でファイルへのパスを指定する、aMachinePolicyPaths メンバーで提供される NULL で終わる文字列の配列へのポインター。 レジストリ ポリシー ファイル形式の詳細については、「レジストリ ポリシー ファイル形式」を参照してください。 ポリシー パスは、ポリシー ファイルへの完全パスまたは相対パスです。

要件

要件 値
サポートされている最小のクライアント Windows 8 [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2012 [デスクトップ アプリのみ]
Header lmjoin.h (Lm.h を含む)

こちらもご覧ください

NetCreateProvisionPackage

NetJoinDomain

NetProvisionComputerAccount

NetRenameMachineInDomain

NetRequestOfflineDomainJoin

NetRequestProvisioningPackageInstall

NetUnjoinDomain

ネットワーク管理機能

ネットワーク管理の概要