UnjoinDomainOrWorkgroup-Methode der Win32_ComputerSystem-Klasse

Die UnjoinDomainOrWorkgroup-Methode entfernt ein Computersystem aus einer Domäne oder Arbeitsgruppe.

In diesem Thema wird MOF-Syntax (Managed Object Format) verwendet. Weitere Informationen zur Verwendung dieser Methode finden Sie unter Aufrufen einer Methode.

Syntax

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

Parameter

Kennwort [in]

Wenn der Parameter UserName einen Kontonamen angibt, muss der Parameter Password auf das Kennwort verweisen, das beim Herstellen einer Verbindung mit dem Domänencontroller verwendet werden soll. Andernfalls muss dieser Parameter NULL sein.

Hinweis

Das Kennwort muss eine hohe Authentifizierungsebene verwenden, mindestens RPC_C_AUTHN_LEVEL_PKT_PRIVACY, wenn eine Verbindung mit Winmgmt oder CoSetProxyBlanket auf dem IWbemServices-Zeiger hergestellt wird. Wenn es lokal zu Winmgmt kommt, ist dies kein Problem.

Benutzername [in]

Zeiger auf eine konstante NULL-Zeichenfolge, die den Kontonamen angibt, der beim Herstellen einer Verbindung mit dem Domänencontroller verwendet werden soll. Muss eine Domäne und ein Benutzerkonto angeben, z. B. "domäne\user" oder "user@domain". Wenn dieser Parameter NULL ist, wird der Aufruferkontext verwendet.

Hinweis

UserName muss beim Herstellen einer Verbindung mit Winmgmt oder CoSetProxyBlanket über den IWbemServices-Zeiger eine hohe Authentifizierungsebene verwenden, mindestens RPC_C_AUTHN_LEVEL_PKT_PRIVACY. Wenn es lokal zu Winmgmt kommt, ist dies kein Problem.

FUnjoinOptions [in]

Satz von Bitflags, die die Optionen zum Aufheben der Verknüpfung definieren.

(0)

Standard. Keine Optionen.

NETSETUP_ACCT_DELETE (4)

Deaktivieren Sie das Active Directory-Konto nach dem Vorgang zum Aufheben der Verknüpfung, aber löschen Sie das Konto nicht.

Rückgabewert

Die UnjoinDomainOrWorkgroup-Methode gibt 0 (null) zurück, wenn erfolglos oder keine Optionen involviert sind. Jeder andere Wert weist auf einen Fehler hin. Fehlercodes finden Sie unter WMI-Fehlerkonstanten oder WbemErrorEnum. Allgemeine HRESULT-Werte finden Sie unter Systemfehlercodes.

Erfolg (0)

Sonstige (1 4294967295)

Bemerkungen

Starten Sie nach dem Aufrufen dieser Methode den betroffenen Computer neu, um die Änderungen anzuwenden.

Beispiele

Aufheben der Einbindung eines Computers aus einer Domäne Das VBScript-Beispiel hebt den lokalen Computer aus seiner aktuellen Domäne auf und deaktiviert das Computerkonto.

Das Skriptbeispiel "Computer aus einer Domäne mithilfe von VBS aufheben " hebt die Einbindung eines angegebenen Computers aus einer Domäne auf. .

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista
Unterstützte Mindestversion (Server)	WindowsServer 2008
Namespace	Root\CIMV2
MOF	CIMWin32.mof
DLL	CIMWin32.dll

Siehe auch

Win32_ComputerSystem

JoinDomainOrWorkgroup-Methode