Método UnjoinDomainOrWorkgroup da classe Win32_ComputerSystem

O método UnjoinDomainOrWorkgroup remove um sistema de computador de um domínio ou grupo de trabalho.

Este tópico usa a sintaxe MOF (Managed Object Format). Para obter mais informações sobre como usar esse método, consulte Chamando um método.

Sintaxe

uint32 UnjoinDomainOrWorkgroup(
  [in] string Password,
  [in] string UserName,
  [in] uint32 FUnjoinOptions = 
);

Parâmetros

Senha [in]

Se o parâmetro UserName especificar um nome de conta, o parâmetro Password deverá apontar para a senha a ser usada ao se conectar ao controlador de domínio. Caso contrário, esse parâmetro deve ser NULL.

Observação

A senha deve usar um alto nível de autenticação, não menos do que RPC_C_AUTHN_LEVEL_PKT_PRIVACY, ao se conectar a Winmgmt ou CoSetProxyBlanket no ponteiro IWbemServices . Se for local para Winmgmt, isso não é uma preocupação.

UserName [in]

Ponteiro para uma cadeia de caracteres terminada em nulo constante que especifica o nome da conta a ser usado ao se conectar ao controlador de domínio. Deve especificar um domínio e uma conta de usuário, por exemplo, "domain\user" ou "user@domain". Se esse parâmetro for NULL, o contexto do chamador será usado.

Observação

UserName deve usar um alto nível de autenticação, não menos do que RPC_C_AUTHN_LEVEL_PKT_PRIVACY, ao se conectar ao Winmgmt ou CoSetProxyBlanket no ponteiro IWbemServices . Se for local para Winmgmt, isso não é uma preocupação.

FUnjoinOptions [in]

Conjunto de sinalizadores de bits definindo as opções de unjoin.

acima (0)

Padrão. Não há opções.

NETSETUP_ACCT_DELETE (4)

Desabilite a conta do Active Directory após a operação unjoin, mas não exclua a conta.

Valor retornado

O método UnjoinDomainOrWorkgroup retorna 0 (zero) no êxito ou quando não há opções envolvidas. Qualquer outro valor indica um erro. Para obter códigos de erro, consulte Constantes de erro WMI ou WbemErrorEnum. Para obter valores gerais de HRESULT , consulte Códigos de erro do sistema.

Sucesso (0)

Outro (1 4294967295)

Comentários

Depois de chamar esse método, reinicie o computador afetado para aplicar as alterações.

Exemplos

O Unjoin a Computer from a Domain O exemplo do VBScript desativa o computador local de seu domínio atual e desabilita a conta do computador.

O exemplo Descompar um computador de um domínio usando script VBS descompõe um computador especificado de um domínio. .

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista
Servidor mínimo com suporte	Windows Server 2008
Namespace	Root\CIMV2
MOF	CIMWin32.mof
DLL	CIMWin32.dll

Confira também

Win32_ComputerSystem

Método JoinDomainOrWorkgroup