Método JoinDomainOrWorkgroup de la clase Win32_ComputerSystem

Artículo
06/12/2023

El método JoinDomainOrWorkgroup une un sistema de equipo a un dominio o grupo de trabajo.

En este tema se usa la sintaxis de Managed Object Format (MOF). Para obtener más información sobre el uso de este método, vea Llamar a un método.

Sintaxis

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

Parámetros

Nombre [in]

Especifica el dominio o grupo de trabajo que se va a unir. No puede ser NULL.

Contraseña [in]

Si el parámetro UserName especifica un nombre de cuenta, el parámetro Password debe apuntar a la contraseña que se usará al conectarse al controlador de dominio. De lo contrario, este parámetro debe ser NULL.

UserName [in]

Puntero a una cadena de caracteres terminada en NULL constante que especifica el nombre de cuenta que se va a usar al conectarse al controlador de dominio. Debe especificar un nombre NetBIOS de dominio y una cuenta de usuario, por ejemplo, Dominio\usuario. Si este parámetro es NULL, se usa la información del autor de la llamada.

También puede usar el nombre principal de usuario (UPPED) con el formato user@domain.

AccountOU [in]

Especifica el puntero a una cadena de caracteres terminada en NULL constante que contiene el nombre de formato RFC 1779 de la unidad organizativa (OU) para la cuenta de equipo. Si especifica este parámetro, la cadena debe contener una ruta de acceso completa; de lo contrario, Accent debe ser NULL.

Ejemplo: "OU=testOU; DC=domain; DC=Dominio; DC=com"

FJoinOptions [in]

Conjunto de marcas de bits que definen las opciones de combinación.

(0)

Predeterminada. Sin opciones de combinación.

NETSETUP_JOIN_DOMAIN (0x00000001)

Une el equipo a un dominio. Si no se especifica este valor, une el equipo a un grupo de trabajo.

NETSETUP_ACCT_CREATE (0x00000002)

Crea la cuenta en el dominio.

NETSETUP_WIN9X_UPGRADE (0x00000010)

La operación de combinación se está produciendo como parte de una actualización.

NETSETUP_DOMAIN_JOIN_IF_JOINED (0x00000020)

Permite una unión a un nuevo dominio incluso si el equipo ya está unido a un dominio.

NETSETUP_JOIN_UNSECURE (0x00000040)

realiza una unión no segura.

Esta opción solicita una unión de dominio a una cuenta creada previamente sin autenticarse con credenciales de usuario de dominio. Esta opción se puede usar junto con NETSETUP_MACHINE_PWD_PASSED opción. En este caso, Password es la contraseña de la cuenta de máquina creada previamente.

Antes de Windows Vista con SP1 y Windows Server 2008, una combinación no segura no se autenticaba en el controlador de dominio. Toda la comunicación se realizó mediante una sesión nula (sin autenticar). A partir de Windows Vista con SP1 y Windows Server 2008, el nombre de la cuenta de equipo y la contraseña se usan para autenticarse en el controlador de dominio.

NETSETUP_MACHINE_PWD_PASSED (0x00000080)

Indica que el parámetro Password especifica una contraseña de cuenta de equipo local en lugar de una contraseña de usuario. Esta marca solo es válida para combinaciones no seguros, que también debe indicar estableciendo la marca NETSETUP_JOIN_UNSECURE.

Si establece esta marca, después de que la operación de combinación se realice correctamente, la contraseña del equipo se establecerá en el valor de Contraseña, si ese valor es una contraseña de máquina válida.

NETSETUP_DEFER_SPN_SET (0x00000100)

Indica que el nombre de la entidad de seguridad de servicio (SPN) y las propiedades DnsHostName del objeto de equipo no se deben actualizar en este momento.

Normalmente, estas propiedades se actualizan durante la operación de combinación. En su lugar, estas propiedades se deben actualizar durante una llamada posterior al método Rename . Estas propiedades siempre se actualizan durante la operación de cambio de nombre.

NETSETUP_JOIN_DC_ACCOUNT (0x00000200)

Permita la unión a un dominio si la cuenta existente es un controlador de dominio.

Nota

Esta marca es compatible con Windows Vista y versiones posteriores.

NETSETUP_AMBIGUOUS_DC (0x00001000)

Cuando se une al dominio, no intente establecer el controlador de dominio preferido en el Registro.

Nota