Méthode JoinDomainOrWorkgroup de la classe Win32_ComputerSystem

Article
06/12/2023

La méthode JoinDomainOrWorkgroup joint un système informatique à un domaine ou un groupe de travail.

Cette rubrique utilise la syntaxe MOF (Managed Object Format). Pour plus d’informations sur l’utilisation de cette méthode, consultez Appel d’une méthode.

Syntaxe

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

Paramètres

Nom [in]

Spécifie le domaine ou le groupe de travail à joindre. Impossible d’avoir la valeur NULL.

Mot de passe [in]

Si le paramètre UserName spécifie un nom de compte, le paramètre Password doit pointer vers le mot de passe à utiliser lors de la connexion au contrôleur de domaine. Sinon, ce paramètre doit avoir la valeur NULL.

UserName [in]

Pointeur vers une chaîne de caractères null constante qui spécifie le nom de compte à utiliser lors de la connexion au contrôleur de domaine. Doit spécifier un nom de domaine NetBIOS et un compte d’utilisateur, par exemple Domaine\utilisateur. Si ce paramètre a la valeur NULL, les informations de l’appelant sont utilisées.

Vous pouvez également utiliser le nom d’utilisateur principal (UPPED) sous la forme user@domain.

AccountOU [in]

Spécifie le pointeur vers une chaîne de caractères null constante qui contient le nom de format RFC 1779 de l’unité d’organisation (UO) pour le compte d’ordinateur. Si vous spécifiez ce paramètre, la chaîne doit contenir un chemin d’accès complet, sinon Accent doit avoir la valeur NULL.

Exemple : « OU=testOU; DC=domain; DC=Domain ; DC=com »

FJoinOptions [in]

Ensemble d’indicateurs de bits qui définissent les options de jointure.

(0)

Par défaut. Aucune option de jointure.

NETSETUP_JOIN_DOMAIN (0x00000001)

Joint l’ordinateur à un domaine. Si cette valeur n’est pas spécifiée, joint l’ordinateur à un groupe de travail.

NETSETUP_ACCT_CREATE (0x00000002)

Crée le compte sur le domaine.

NETSETUP_WIN9X_UPGRADE (0x00000010)

L’opération de jointure se produit dans le cadre d’une mise à niveau.

NETSETUP_DOMAIN_JOIN_IF_JOINED (0x00000020)

Autorise une jointure à un nouveau domaine même si l’ordinateur est déjà joint à un domaine.

NETSETUP_JOIN_UNSECURE (0x00000040)

Effectue une jonction non sécurisée.

Cette option demande une jointure de domaine à un compte précréé sans authentification avec les informations d’identification de l’utilisateur de domaine. Cette option peut être utilisée conjointement avec NETSETUP_MACHINE_PWD_PASSED option. Dans ce cas, le mot de passe est le mot de passe du compte d’ordinateur précréé.

Avant Windows Vista avec SP1 et Windows Server 2008, une jointure non sécurisée ne s’authentifie pas auprès du contrôleur de domaine. Toutes les communications ont été effectuées à l’aide d’une session null (non authentifiée). À compter de Windows Vista avec SP1 et Windows Server 2008, le nom du compte d’ordinateur et le mot de passe sont utilisés pour s’authentifier auprès du contrôleur de domaine.

NETSETUP_MACHINE_PWD_PASSED (0x00000080)

Indique que le paramètre Password spécifie un mot de passe de compte d’ordinateur local plutôt qu’un mot de passe utilisateur. Cet indicateur est valide uniquement pour les jointures non sécurisées, ce que vous devez indiquer en définissant également l’indicateur NETSETUP_JOIN_UNSECURE.

Si vous définissez cet indicateur, une fois l’opération de jointure réussie, le mot de passe de l’ordinateur est défini sur la valeur Mot de passe, si cette valeur est un mot de passe d’ordinateur valide.

NETSETUP_DEFER_SPN_SET (0x00000100)

Indique que le nom du principal de service (SPN) et les propriétés DnsHostName sur l’objet ordinateur ne doivent pas être mises à jour pour le moment.

En règle générale, ces propriétés sont mises à jour pendant l’opération de jointure. Au lieu de cela, ces propriétés doivent être mises à jour lors d’un appel suivant à la méthode Rename . Ces propriétés sont toujours mises à jour pendant l’opération de renommage.

NETSETUP_JOIN_DC_ACCOUNT (0x00000200)

Autorisez la jointure de domaine si le compte existant est un contrôleur de domaine.

Notes

Cet indicateur est pris en charge sur Windows Vista et versions ultérieures.

NETSETUP_AMBIGUOUS_DC (0x00001000)

Lorsque vous rejoignez le domaine, n’essayez pas de définir le contrôleur de domaine préféré dans le Registre.

Notes