Méthode UnjoinDomainOrWorkgroup de la classe Win32_ComputerSystem
La méthode UnjoinDomainOrWorkgroup supprime un système informatique d’un domaine ou d’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 UnjoinDomainOrWorkgroup(
[in] string Password,
[in] string UserName,
[in] uint32 FUnjoinOptions =
);
Paramètres
-
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 être NULL.
Notes
Le mot de passe doit utiliser un niveau d’authentification élevé, au moins RPC_C_AUTHN_LEVEL_PKT_PRIVACY, lors de la connexion à Winmgmt ou CoSetProxyBlanket sur le pointeur IWbemServices . S’il est local dans Winmgmt, ce n’est pas un problème.
-
UserName [in]
-
Pointeur vers une chaîne de caractères constante terminée par un caractère null qui spécifie le nom de compte à utiliser lors de la connexion au contrôleur de domaine. Doit spécifier un domaine et un compte d’utilisateur, par exemple, « domaine\utilisateur » ou « user@domain ». Si ce paramètre a la valeur NULL, le contexte de l’appelant est utilisé.
Notes
UserName doit utiliser un niveau d’authentification élevé, au moins RPC_C_AUTHN_LEVEL_PKT_PRIVACY, lors de la connexion à Winmgmt ou CoSetProxyBlanket sur le pointeur IWbemServices . S’il est local dans Winmgmt, ce n’est pas un problème.
-
FUnjoinOptions [in]
-
Ensemble d’indicateurs de bits définissant les options de dissociation.
-
(0)
-
Par défaut. Aucune option.
-
NETSETUP_ACCT_DELETE (4)
-
Désactivez le compte Active Directory après l’opération de dissociation, mais ne supprimez pas le compte.
Valeur retournée
La méthode UnjoinDomainOrWorkgroup retourne 0 (zéro) en cas de réussite ou lorsqu’aucune option n’est impliquée. Toute autre valeur indique une erreur. Pour les codes d’erreur, consultez Constantes d’erreur WMI ou WbemErrorEnum. Pour connaître les valeurs HRESULT générales, consultez Codes d’erreur système.
-
Réussite (0)
-
Autre (1 4294967295)
Notes
Après avoir appelé cette méthode, redémarrez l’ordinateur affecté pour appliquer les modifications.
Exemples
Dissocier un ordinateur d’un domaine L’exemple VBScript dissocie l’ordinateur local de son domaine actuel et désactive le compte d’ordinateur.
L’exemple de script Dissocier un ordinateur d’un domaine à l’aide de VBS dissocie un ordinateur spécifié d’un domaine. .
Spécifications
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge |
Windows Vista |
| Serveur minimal pris en charge |
Windows Server 2008 |
| Espace de noms |
Racine\CIMV2 |
| MOF |
|
| DLL |
|