Método UnjoinDomainOrWorkgroup de la clase Win32_ComputerSystem
El método UnjoinDomainOrWorkgroup quita un sistema de equipo de 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 UnjoinDomainOrWorkgroup(
[in] string Password,
[in] string UserName,
[in] uint32 FUnjoinOptions =
);
Parámetros
-
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.
Nota
La contraseña debe usar un nivel de autenticación alto, no menor que RPC_C_AUTHN_LEVEL_PKT_PRIVACY, al conectarse a Winmgmt o CoSetProxyBlanket en el puntero IWbemServices . Si es local en Winmgmt, esto no es un problema.
-
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 dominio y una cuenta de usuario, por ejemplo, "dominio\usuario" o "user@domain". Si este parámetro es NULL, se usa el contexto del autor de la llamada.
Nota
UserName debe usar un nivel de autenticación alto, no menor que RPC_C_AUTHN_LEVEL_PKT_PRIVACY, al conectarse a Winmgmt o CoSetProxyBlanket en el puntero IWbemServices . Si es local en Winmgmt, esto no es un problema.
-
FUnjoinOptions [in]
-
Conjunto de marcas de bits que definen las opciones de unjoin.
-
(0)
-
Predeterminada. No hay opciones.
-
NETSETUP_ACCT_DELETE (4)
-
Deshabilite la cuenta de Active Directory después de la operación de desenlazación, pero no elimine la cuenta.
Valor devuelto
El método UnjoinDomainOrWorkgroup devuelve 0 (cero) si se realiza correctamente o cuando no hay opciones implicadas. Cualquier otro valor indica un error. Para obtener códigos de error, consulte Constantes de error WMI o WbemErrorEnum. Para obtener valores HRESULT generales, consulte Códigos de error del sistema.
-
Correcto (0)
-
Otros (1 4294967295)
Comentarios
Después de llamar a este método, reinicie el equipo afectado para aplicar los cambios.
Ejemplos
Desenlazación de un equipo de un dominio El ejemplo de VBScript quita el equipo local de su dominio actual y deshabilita la cuenta de equipo.
El ejemplo Unjoin a Computer from a Domain using VBS script unjoins a specified computer from a domain. .
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible |
Windows Vista |
| Servidor mínimo compatible |
Windows Server 2008 |
| Espacio de nombres |
Root\CIMV2 |
| MOF |
|
| Archivo DLL |
|