다음을 통해 공유


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 호출)에서 컴퓨터를 제거해야 합니다. 이 메서드를 호출한 후 영향을 받는 컴퓨터를 다시 시작하여 변경 내용을 적용합니다.

UserNamePassword는 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
CIMWin32.mof
DLL
CIMWin32.dll

참고 항목

Win32_ComputerSystem

UnjoinDo기본OrWorkgroup 메서드