Метод JoinDomainOrWorkgroup класса Win32_ComputerSystem

Статья
06/12/2023

Метод JoinDomainOrWorkgroup присоединяет компьютерную систему к домену или рабочей группе.

В этом разделе используется синтаксис формата управляемого объекта (MOF). Дополнительные сведения об использовании этого метода см. в разделе Вызов метода.

Синтаксис

uint32 JoinDomainOrWorkgroup(
  [in] string Name,
  [in] string Password,
  [in] string UserName,
  [in] string AccountOU,
  [in] uint32 FJoinOptions = 
);

Параметры

Имя [in]

Указывает домен или рабочую группу для присоединения. Не может иметь значение NULL.

Пароль [вход]

Если параметр UserName указывает имя учетной записи, параметр Password должен указывать на пароль, используемый при подключении к контроллеру домена. В противном случае этот параметр должен иметь значение NULL.

UserName [in]

Указатель на константную строку символов, завершающуюся null, которая указывает имя учетной записи, используемое при подключении к контроллеру домена. Необходимо указать netBIOS-имя домена и учетную запись пользователя, например Домен\пользователь. Если этот параметр имеет значение NULL, используются сведения о вызывающем объекте.

Вы также можете использовать имя участника-пользователя (UPPED) в форме user@domain.

AccountOU [in]

Указывает указатель на константную строку символов, завершающуюся null, которая содержит имя в формате RFC 1779 подразделения для учетной записи компьютера. Если этот параметр указан, строка должна содержать полный путь, в противном случае параметр Accent должен иметь значение NULL.

Пример: "OU=testOU; DC = домен; DC = домен; DC=com"

FJoinOptions [вход]

Набор битовых флагов, определяющих параметры соединения.

(0)

По умолчанию. Нет параметров присоединения.

NETSETUP_JOIN_DOMAIN (0x00000001)

Присоединяет компьютер к домену. Если это значение не указано, присоединяет компьютер к рабочей группе.

NETSETUP_ACCT_CREATE (0x00000002)

Создает учетную запись в домене.

NETSETUP_WIN9X_UPGRADE (0x00000010)

Операция соединения выполняется в рамках обновления.

NETSETUP_DOMAIN_JOIN_IF_JOINED (0x00000020)

Разрешает присоединение к новому домену, даже если компьютер уже присоединен к домену.

NETSETUP_JOIN_UNSECURE (0x00000040)

Выполняет незащищенное присоединение.

Этот вариант запрашивает присоединение к домену к предварительно созданной учетной записи без проверки подлинности с помощью учетных данных пользователя домена. Этот параметр можно использовать в сочетании с параметром NETSETUP_MACHINE_PWD_PASSED . В этом случае Пароль — это пароль предварительно созданной учетной записи компьютера.

До выпуска Windows Vista с пакетом обновления 1 (SP1) и Windows Server 2008 небезопасное присоединение не выполняло проверку подлинности на контроллере домена. Все обмен данными выполнялись с использованием сеанса со значением NULL (без проверки подлинности). Начиная с Windows Vista с пакетом обновления 1 (SP1) и Windows Server 2008, имя и пароль учетной записи компьютера используются для проверки подлинности на контроллере домена.

NETSETUP_MACHINE_PWD_PASSED (0x00000080)

Указывает, что параметр Password задает пароль учетной записи локального компьютера, а не пароль пользователя. Этот флаг действителен только для незащищенных соединений, которые необходимо указать, также задав флаг NETSETUP_JOIN_UNSECURE.

Если этот флаг установлен, то после успешной операции присоединения пароль компьютера будет установлен в значение Пароль, если это значение является допустимым паролем компьютера.

NETSETUP_DEFER_SPN_SET (0x00000100)

Указывает, что в данный момент не следует обновлять имя субъекта-службы и свойства DnsHostName объекта-компьютера.

Как правило, эти свойства обновляются во время операции соединения. Вместо этого эти свойства следует обновить во время последующего вызова метода Rename . Эти свойства всегда обновляются во время операции переименования.

NETSETUP_JOIN_DC_ACCOUNT (0x00000200)

Разрешите присоединение к домену, если существующая учетная запись является контроллером домена.

Примечание

Этот флаг поддерживается в Windows Vista и более поздних версиях.

NETSETUP_AMBIGUOUS_DC (0x00001000)

При присоединении к домену не пытайтесь задать предпочтительный контроллер домена в реестре.

Примечание