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 ヘッダー ファイルで定義されている次の値を使用する必要があります。
| 値 | 意味 |
|---|---|
|
このパッケージのバージョンは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 つ以上を指定できます。
| 値 | 意味 |
|---|---|
|
呼び出し元に特権によるアカウントの作成が必要な場合、このオプションでは、以前のバージョンの Windows で実行されているドメイン コントローラーとの相互運用性を可能にするアカウント作成関数を使用して、失敗時に再試行が発生します。
downlevel 特権のサポートを使用する場合、 lpMachineAccountOU はサポートされません。 |
|
名前付きアカウントが既に存在する場合は、既存のアカウントの再利用が試行されます。
このオプションでは、この操作 (ドメイン管理者またはオブジェクト所有者) に十分な資格情報が必要です。 |
|
コンピューター名の既定のコンピューター アカウント パスワードを小文字で使用します。 これは主に、事前に作成されたアカウントで通常この既定のパスワードが使用される、以前のセキュリティ保護されていない参加モデルをサポートするためです。 |
|
ドメイン内のドメイン コントローラーでアカウントを検索しないでください。 このオプションを使用すると、操作が高速になりますが、呼び出し元が同じ名前のアカウントが最近作成されていないことが確実な場合にのみ使用する必要があります。
このオプションは、 lpDcName パラメーターが指定されている場合にのみ有効です。 前提条件が満たされると、このオプションを使用すると、バッチ処理などのシナリオに役立つプロビジョニングを高速化する必要があります。 |
|
このオプションは、ローカル コンピューター上のすべてのルート証明機関証明書を取得し、プロビジョニング パッケージに追加します。
メモこのフラグは、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 を含む) |