JoinDomainOrWorkgroup-Methode der Win32_ComputerSystem-Klasse

Artikel
06/12/2023

Die JoinDomainOrWorkgroup-Methode verknüpft ein Computersystem mit 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 JoinDomainOrWorkgroup(
  [in] string Name,
  [in] string Password,
  [in] string UserName,
  [in] string AccountOU,
  [in] uint32 FJoinOptions = 
);

Parameter

Name [in]

Gibt die Domäne oder Arbeitsgruppe an, die bzw. die beitreten soll. Darf nicht NULL sein.

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.

UserName [in]

Zeiger auf eine konstante NULL-endende Zeichenfolge, die den Kontonamen angibt, der beim Herstellen einer Verbindung mit dem Domänencontroller verwendet werden soll. Muss einen NetBIOS-Domänennamen und ein Benutzerkonto angeben, z. B. Domäne\Benutzer. Wenn dieser Parameter NULL ist, werden die Aufruferinformationen verwendet.

Sie können auch den Benutzerprinzipalnamen (UPPED) in der Form user@domain verwenden.

AccountOU [in]

Gibt den Zeiger auf eine konstante NULL-endende Zeichenfolge an, die den RFC 1779-Formatnamen der Organisationseinheit (OU) für das Computerkonto enthält. Wenn Sie diesen Parameter angeben, muss die Zeichenfolge einen vollständigen Pfad enthalten, andernfalls muss AccentNULL sein.

Beispiel: "OU=testOU; DC=Domäne; DC=Domäne; DC=com"

FJoinOptions [in]

Satz von Bitflags, die die Verknüpfungsoptionen definieren.

(0)

Standard. Keine Joinoptionen.

NETSETUP_JOIN_DOMAIN (0x00000001)

Verknüpft den Computer mit einer Domäne. Wenn dieser Wert nicht angegeben ist, wird der Computer mit einer Arbeitsgruppe verknüpft.

NETSETUP_ACCT_CREATE (0x00000002)

Erstellt das Konto in der Domäne.

NETSETUP_WIN9X_UPGRADE (0x00000010)

Der Joinvorgang erfolgt im Rahmen eines Upgrades.

NETSETUP_DOMAIN_JOIN_IF_JOINED (0x00000020)

Ermöglicht den Beitritt zu einer neuen Domäne, auch wenn der Computer bereits einer Domäne angehört.

NETSETUP_JOIN_UNSECURE (0x00000040)

Führt einen unsicheren Beitritt durch.

Diese Option fordert einen Domänenbeitritt zu einem vorab erstellten Konto an, ohne sich mit Domänenbenutzeranmeldeinformationen zu authentifizieren. Diese Option kann in Verbindung mit NETSETUP_MACHINE_PWD_PASSED Option verwendet werden. In diesem Fall ist Password das Kennwort des vorab erstellten Computerkontos.

Vor Windows Vista mit SP1 und Windows Server 2008 wurde eine unsichere Einbindung nicht beim Domänencontroller authentifiziert. Die gesamte Kommunikation wurde mit einer NULL-Sitzung (nicht authentifiziert) durchgeführt. Ab Windows Vista mit SP1 und Windows Server 2008 werden der Computerkontoname und das Kennwort für die Authentifizierung beim Domänencontroller verwendet.

NETSETUP_MACHINE_PWD_PASSED (0x00000080)

Gibt an, dass der Parameter Password anstelle eines Benutzerkennworts ein Kontokennwort für den lokalen Computer angibt. Dieses Flag ist nur für ungesicherte Joins gültig, die Sie angeben müssen, indem Sie auch das flag NETSETUP_JOIN_UNSECURE festlegen.

Wenn Sie dieses Flag festlegen, wird das Computerkennwort nach erfolgreichem Joinvorgang auf den Wert Kennwort festgelegt, wenn es sich um ein gültiges Computerkennwort handelt.

NETSETUP_DEFER_SPN_SET (0x00000100)

Gibt an, dass der Dienstprinzipalname (SPN) und die DnsHostName-Eigenschaften des Computerobjekts zu diesem Zeitpunkt nicht aktualisiert werden sollen.

In der Regel werden diese Eigenschaften während des Joinvorgangs aktualisiert. Stattdessen sollten diese Eigenschaften während eines nachfolgenden Aufrufs der Rename-Methode aktualisiert werden. Diese Eigenschaften werden während des Umbenennungsvorgangs immer aktualisiert.

NETSETUP_JOIN_DC_ACCOUNT (0x00000200)

Lassen Sie den Domänenbeitritt zu, wenn ein vorhandenes Konto ein Domänencontroller ist.

Hinweis

Dieses Flag wird unter Windows Vista und höher unterstützt.

NETSETUP_AMBIGUOUS_DC (0x00001000)

Versuchen Sie beim Beitritt zur Domäne nicht, den bevorzugten Domänencontroller in der Registrierung festzulegen.

Hinweis