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 헤더 파일에 정의된 다음 값을 사용해야 합니다.
| 값 | 의미 |
|---|---|
|
이 패키지의 버전은 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 헤더 파일에 정의된 다음 값 중 하나 이상일 수 있습니다.
| 값 | 의미 |
|---|---|
|
호출자가 권한으로 계정을 생성해야 하는 경우 이 옵션을 사용하면 이전 버전의 Windows에서 실행되는 도메인 컨트롤러와의 상호 운용성을 가능하게 하는 계정 만들기 함수를 사용하여 실패 시 다시 시도합니다.
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 함수에 대한 플래그를 제공합니다.
프로비전 패키지는 도메인 조인 외에도 컴퓨터에 인증서 및 정책을 제공할 수 있습니다. 프로비저닝 패키지는 다음 네 가지 방법으로 사용할 수 있습니다.
- 도메인 가입
- 도메인 가입 및 인증서 설치
- 도메인 가입 및 정책 설치
- 인증서 및 정책의 도메인 가입 및 설치
인증서를 패키지에 추가해야 하는 경우 이 구조는 aCertTemplateNames 멤버를 NULL로 종료된 인증서 템플릿 이름의 배열로 제공합니다. aCertTemplateNames 멤버를 사용하려면 cCertTemplateNames 멤버가 배열에 있는 항목 수의 명시적 개수를 제공해야 합니다.
정책을 추가하는 방법에는 두 가지가 있습니다. 다음 방법 중 하나 또는 둘 다를 사용할 수 있습니다.
- 정책 이름 - NULL로 종료된 정책 이름의 배열이 aMachinePolicyNames 멤버에 제공됩니다. 런타임 동안 정책 이름은 AD의 정책 이름에 매핑되고 엔터프라이즈 공간의 정책을 나타내는 GUID가 검색됩니다. aMachinePolicyNames 멤버를 사용하려면 cMachinePolicyNames 멤버가 배열에 있는 항목 수의 명시적 개수를 제공해야 합니다.
- 정책 경로 - 레지스트리 정책 파일 형식의 파일 경로를 지정하는 aMachinePolicyPaths 멤버에 제공된 NULL로 끝나는 문자열 배열에 대한 포인터입니다. 레지스트리 정책 파일 형식에 대한 자세한 내용은 레지스트리 정책 파일 형식을 참조하세요. 정책 경로는 정책 파일의 전체 또는 상대 경로입니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 8 [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2012 [데스크톱 앱만 해당] |
| 머리글 | lmjoin.h(Lm.h 포함) |
추가 정보
피드백
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요. https://aka.ms/ContentUserFeedback
다음에 대한 사용자 의견 제출 및 보기