Win32_ComputerSystem 类的 JoinDomainOrWorkgroup 方法

项目
06/12/2023

JoinDomainOrWorkgroup 方法将计算机系统加入域或工作组。

本主题使用托管对象格式 (MOF) 语法。有关使用此方法的详细信息，请参阅调用方法。

语法

uint32 JoinDomainOrWorkgroup(
  [in] string Name,
  [in] string Password,
  [in] string UserName,
  [in] string AccountOU,
  [in] uint32 FJoinOptions = 
);

参数

Name [in]

指定要加入的域或工作组。不能为 NULL。

密码 [in]

如果 UserName 参数指定帐户名称，则 Password 参数必须指向连接到域控制器时要使用的密码。否则，此参数必须为 NULL。

UserName [in]

指向以 null 结尾的常量字符串的指针，该字符串指定连接到域控制器时要使用的帐户名称。必须指定域 NetBIOS 名称和用户帐户，例如 Domain\user。如果此参数为 NULL，则使用调用方信息。

还可以将用户主体名称 (UPPED) 格式user@domain。

AccountOU [in]

指定指向常 量以 null 结尾的字符串的指针，该字符串包含计算机帐户的组织单位 (OU) 的 RFC 1779 格式名称。如果指定此参数，则字符串必须包含完整路径，否则 Accent 必须为 NULL。

示例：“OU=testOU;DC=domain;DC=域;DC=com”

FJoinOptions [in]

定义联接选项的位标志集。

(0)

默认。没有联接选项。

NETSETUP_JOIN_DOMAIN (0x00000001)

将计算机加入域。如果未指定此值，则将计算机加入工作组。

NETSETUP_ACCT_CREATE (0x00000002)

在域上创建帐户。

NETSETUP_WIN9X_UPGRADE (0x00000010)

联接操作是在升级过程中发生的。

NETSETUP_DOMAIN_JOIN_IF_JOINED (0x00000020)

允许加入新域，即使计算机已加入域。

NETSETUP_JOIN_UNSECURE (0x00000040)

执行不安全的加入操作。

此选项请求域加入到预先创建的帐户，而无需使用域用户凭据进行身份验证。此选项可与 NETSETUP_MACHINE_PWD_PASSED 选项结合使用。在本例中，密码是预先创建的计算机帐户的密码。

在 Windows Vista SP1 和 Windows Server 2008 之前，不安全的加入未向域控制器进行身份验证。所有通信都是使用 null (未经身份验证) 会话执行的。从 SP1 和 Windows Server 2008 的 Windows Vista 开始，计算机帐户名称和密码用于向域控制器进行身份验证。

NETSETUP_MACHINE_PWD_PASSED (0x00000080)

指示 Password 参数指定本地计算机帐户密码，而不是用户密码。此标志仅对不安全的联接有效，必须同时设置NETSETUP_JOIN_UNSECURE标志来指示该联接。

如果设置此标志，则在联接操作成功后，如果该值是有效的计算机密码，则计算机密码将设置为 “密码”值。

NETSETUP_DEFER_SPN_SET (0x00000100)

指示当前不应更新计算机对象上的服务主体名称 (SPN) 和 DnsHostName 属性。

通常，这些属性在联接操作期间更新。相反，应在后续调用 Rename 方法期间更新这些属性。这些属性在重命名操作期间始终更新。

NETSETUP_JOIN_DC_ACCOUNT (0x00000200)

如果现有帐户是域控制器，则允许域加入。

注意

Windows Vista 及更高版本支持此标志。

NETSETUP_AMBIGUOUS_DC (0x00001000)

加入域时，不要尝试在注册表中设置首选域控制器。

注意