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 |
|
| DLL |
|