joinDo기본 Win32_ComputerSystem 클래스의OrWorkgroup 메서드
JoinDo기본OrWorkgroup 메서드는 컴퓨터 시스템을 할 일기본 또는 작업 그룹에 조인합니다.
이 항목에서는 MOF(Managed Object Format) 구문을 사용합니다. 이 메서드를 사용하는 방법에 대한 자세한 내용은 메서드 호출을 참조 하세요.
구문
uint32 JoinDomainOrWorkgroup(
[in] string Name,
[in] string Password,
[in] string UserName,
[in] string AccountOU,
[in] uint32 FJoinOptions =
);
매개 변수
-
Name [in]
-
조인할 do기본 또는 작업 그룹을 지정합니다. NULL일 수 없습니다.
-
암호 [in]
-
UserName 매개 변수가 계정 이름을 지정하는 경우 암호 매개 변수는 do기본 컨트롤러에 연결할 때 사용할 암호를 가리킵니다. 그렇지 않으면 이 매개 변수는 NULL이어야 합니다.
-
UserName [in]
-
do기본 컨트롤러에 연결할 때 사용할 계정 이름을 지정하는 null로 끝나는 상수 문자열에 대한 포인터입니다. Do기본 NetBIOS 이름 및 사용자 계정(예: Do기본\user)을 지정해야 합니다. 이 매개 변수가 NULL이면 호출자 정보가 사용됩니다.
양식 user@do기본 UPPED(사용자 계정 이름)를 사용할 수도 있습니다.
-
AccountOU [in]
-
컴퓨터 계정에 대한 OU(조직 구성 단위)의 RFC 1779 형식 이름을 포함하는 null로 끝나는 상수 문자열에 대한 포인터를 지정합니다. 이 매개 변수를 지정하는 경우 문자열에 전체 경로가 포함되어야 합니다. 그렇지 않으면 Accent이 NULL이어야 합니다.
예: "OU=testOU; DC=do기본; DC=Do기본; DC=com"
-
FJoinOptions [in]
-
조인 옵션을 정의하는 비트 플래그 집합입니다.
-
(0)
-
기본값. 조인 옵션이 없습니다.
-
NETSETUP_JOIN_DOMAIN(0x00000001)
-
할 일기본 컴퓨터를 조인합니다. 이 값을 지정하지 않으면 컴퓨터를 작업 그룹에 조인합니다.
-
NETSETUP_ACCT_CREATE(0x00000002)
-
do기본 계정을 만듭니다.
-
NETSETUP_WIN9X_UPGRADE(0x00000010)
-
조인 작업이 업그레이드의 일부로 발생합니다.
-
NETSETUP_DOMAIN_JOIN_IF_JOINED(0x00000020)
-
컴퓨터가 이미 할 일기본 조인되어 있더라도 새 할 일기본 조인을 허용합니다.
-
NETSETUP_JOIN_UNSECURE(0x00000040)
-
보안되지 않은 가입을 수행합니다.
이 옵션은 do기본 사용자 자격 증명을 사용하여 인증하지 않고 미리 만든 계정에 할기본 조인을 요청합니다. 이 옵션은 NETSETUP_MACHINE_PWD_PASSED 옵션과 함께 사용할 수 있습니다. 이 경우 암호 는 미리 만든 컴퓨터 계정의 암호입니다.
WINDOWS Vista SP1 및 Windows Server 2008 이전에는 안전하지 않은 조인이 do기본 컨트롤러에 인증되지 않았습니다. 모든 통신은 null(인증되지 않은) 세션을 사용하여 수행되었습니다. WINDOWS Vista SP1 및 Windows Server 2008부터 컴퓨터 계정 이름 및 암호는 do기본 컨트롤러에 인증하는 데 사용됩니다.
-
NETSETUP_MACHINE_PWD_PASSED(0x00000080)
-
Password 매개 변수가 사용자 암호가 아닌 로컬 컴퓨터 계정 암호를 지정한다는 것을 나타냅니다. 이 플래그는 보안되지 않은 조인에만 유효하며 NETSETUP_JOIN_UNSECURE 플래그를 설정하여 표시해야 합니다.
이 플래그를 설정한 경우 조인 작업이 성공하면 해당 값이 유효한 컴퓨터 암호인 경우 컴퓨터 암호가 암호 값으로 설정됩니다.
-
NETSETUP_DEFER_SPN_SET(0x00000100)
-
현재 컴퓨터 개체의 SPN(서비스 주체 이름) 및 DnsHostName 속성을 업데이트해서는 안 됨을 나타냅니다.
일반적으로 이러한 속성은 조인 작업 중에 업데이트됩니다. 대신 Rename 메서드에 대한 후속 호출 중에 이러한 속성을 업데이트해야 합니다. 이러한 속성은 이름 바꾸기 작업 중에 항상 업데이트됩니다.
-
NETSETUP_JOIN_DC_ACCOUNT(0x00000200)
-
기존 계정이 할 일기본 컨트롤러인 경우 do기본 조인을 허용합니다.
참고 항목
이 플래그는 Windows Vista 이상에서 지원됩니다.
-
NETSETUP_AMBIGUOUS_DC(0x00001000)
-
할 일을 조인할 때기본 레지스트리에서 기본 설정 do기본 컨트롤러를 설정하려고 하지 않습니다.
참고 항목
이 플래그는 Windows 7, Windows Server 2008 R2 이상에서 지원됩니다.
-
NETSETUP_NO_NETLOGON_CACHE(0x00002000)
-
할 일을 조인할 때기본 Netlogon 캐시를 만들지 마세요.
참고 항목
이 플래그는 Windows 7, Windows Server 2008 R2 이상에서 지원됩니다.
-
NETSETUP_DONT_CONTROL_SERVICES(0x00004000)
-
할 일을 조인할 때기본 Netlogon 서비스를 강제로 시작하지 마세요.
참고 항목
이 플래그는 Windows 7, Windows Server 2008 R2 이상에서 지원됩니다.
-
NETSETUP_SET_MACHINE_NAME(0x00008000)
-
오프라인 조인에 대해서만 do기본 조인하는 경우 대상 컴퓨터 호스트 이름 및 NetBIOS 이름을 설정합니다.
참고 항목
이 플래그는 Windows 7, Windows Server 2008 R2 이상에서 지원됩니다.
-
NETSETUP_FORCE_SPN_SET(0x00010000)
-
do기본 조인할 때 do기본 조인 중에 다른 설정을 재정의하고 SPN(서비스 사용자 이름)을 설정합니다.
참고 항목
이 플래그는 Windows 7, Windows Server 2008 R2 이상에서 지원됩니다.
-
NETSETUP_NO_ACCT_REUSE(0x00020000)
-
do기본 조인할 때 기존 계정을 다시 사용하지 마세요.
참고 항목
이 플래그는 Windows 7, Windows Server 2008 R2 이상에서 지원됩니다.
-
NETSETUP_IGNORE_UNSUPPORTED_FLAGS(0x10000000)
-
이 비트가 설정되면 JoinDo기본OrWorkgroup 함수에서 인식할 수 없는 플래그가 무시되고 NetJoinDo기본 플래그가 설정되지 않은 것처럼 동작합니다.
반환 값
다음 숫자 값 중 하나를 포함할 수 있는 시스템 오류 코드를 반환합니다. 다른 모든 숫자는 오류를 나타냅니다. 추가 오류 코드는 WMI 오류 상수 또는 WbemErrorEnum을 참조하세요.
-
성공
-
0
-
5
-
액세스가 거부되었습니다.
-
87
-
매개 변수가 올바르지 않습니다.
-
110
-
시스템에서 지정된 개체를 열 수 없습니다.
-
1323
-
암호를 업데이트할 수 없습니다.
-
1326
-
로그온 실패: 알 수 없는 사용자 이름 또는 잘못된 암호입니다.
-
1355
-
지정한 도메인이 존재하지 않거나 연결할 수 없습니다.
-
2224
-
계정이 이미 있습니다.
-
2691
-
컴퓨터가 do기본 이미 조인되어 있습니다.
-
2692
-
컴퓨터가 현재 할 일기본 조인되어 있지 않습니다.
-
WBEM_E_ENCRYPTED_CONNECTION_REQUIRED
-
0x80041087
암호 및 UserName이 지정되었지만 인증 수준이 RPC_C_AUTHN_LEVEL_PKT_PRIVACY 않습니다. Visual Basic의 경우 wbemErrEncrypted커넥트ionRequired가 반환됩니다.
-
기타
-
1 4294967295
설명
do기본에서 작업 그룹으로 컴퓨터를 이동하는 경우 이 메서드를 호출하여 작업 그룹(JoinDo기본OrWorkgroup 호출)을 호출하기 전에 do기본(UnjoinDo기본OrWorkgroup 호출)에서 컴퓨터를 제거해야 합니다. 이 메서드를 호출한 후 영향을 받는 컴퓨터를 다시 시작하여 변경 내용을 적용합니다.
UserName 및 Password는 null로 설정할 수 있습니다. 그러나 WMI에 대한 연결 인증은 스크립트에서 6이어야 하며, Visual Basic의 WbemAuthenticationLevelPktPrivacy 및 wbemdisp.dll 라이브러리를 사용할 수 있는 다른 언어여야 합니다. 자세한 내용은 VBScript를 사용하여 기본 프로세스 보안 수준 설정을 참조하세요.
C++에서 RPC_C_AUTHN_LEVEL_PKT_PRIVACY 인증을 CoInitializeSecurity, 전체 프로세스 또는 CoSetProxyBlanket에서 설정하여 IWbemServices 프록시에 연결합니다. 자세한 내용은 C++ 를 사용하여 인증 설정 및 IWbemServices 및 기타 프록시에서 보안 설정을 참조하세요.
예제
다음 VBScript 코드 예제에서는 컴퓨터를 할 일기본 조인하고 Active Directory에서 컴퓨터의 계정을 만듭니다.
Const JOIN_DOMAIN = 1
Const ACCT_CREATE = 2
Const ACCT_DELETE = 4
Const WIN9X_UPGRADE = 16
Const DOMAIN_JOIN_IF_JOINED = 32
Const JOIN_UNSECURE = 64
Const MACHINE_PASSWORD_PASSED = 128
Const DEFERRED_SPN_SET = 256
Const INSTALL_INVOCATION = 262144
strDomain = "FABRIKAM"
strPassword = "ls4k5ywA"
strUser = "shenalan"
Set objNetwork = CreateObject("WScript.Network")
strComputer = objNetwork.ComputerName
Set objComputer = GetObject("winmgmts:{impersonationLevel=Impersonate}!\\" & strComputer & _
"\root\cimv2:Win32_ComputerSystem.Name='" & strComputer & "'")
ReturnValue = objComputer.JoinDomainOrWorkGroup(strDomain, _
strPassword, _
strDomain & "\" & strUser, _
NULL, _
JOIN_DOMAIN + ACCT_CREATE)
요구 사항
요구 사항 | 값 |
---|---|
지원되는 최소 클라이언트 |
Windows Vista |
지원되는 최소 서버 |
Windows Server 2008 |
네임스페이스 |
Root\CIMV2 |
MOF |
|
DLL |
|