Добавление локального компьютера в домен или рабочую группу.

Синтаксис

Add-Computer [-DomainName] <string> [-Credential <PSCredential>] [-OUPath <string>] [-Server <string>] [-Unsecure] [-PassThru] [-Confirm] [-WhatIf] [<CommonParameters>]

Add-Computer [-WorkGroupName] <string> [-Credential <PSCredential>] [-PassThru] [-Confirm] [-WhatIf] [<CommonParameters>]

Описание

Командлет Add-Computer добавляет локальный компьютер в домен или рабочую группу или перемещает его из одного домена в другой. Также он создает учетную запись домена, если компьютер добавлен в домен без учетной записи.

Параметры этого командлета можно использовать для задания подразделения и контроллера домена или для выполнения незащищенного присоединения.

Для получения результатов выполнения команды используются параметры Verbose и PassThru.

Параметры

-Credential <PSCredential>

Задает учетную запись пользователя, который располагает разрешением для выполнения этого действия. По умолчанию используется значение "Текущий пользователь".

Введите имя пользователя, например "User01" или "Domain01\User01", или введите объект PSCredential, например объект, создаваемый командлетом Get-Credential. При вводе имени пользователя система запросит пароль.

Обязательно?	false
Позиция?	named
Значение по умолчанию	Current User Account Credentials
Принимать входные данные из конвейера?	false
Принимать подстановочные знаки?	false

-DomainName <string>

Задает домен для учетной записи компьютера. Это обязательный параметр.

Обязательно?	true
Позиция?	2
Значение по умолчанию
Принимать входные данные из конвейера?	false
Принимать подстановочные знаки?	false

-OUPath <string>

Задает подразделение для учетной записи домена. Введите полное различающееся имя подразделения. По умолчанию используется подразделение, принятое по умолчанию для объектов-компьютеров в домене.

Обязательно?	false
Позиция?	named
Значение по умолчанию	The default OU for machine objects for in the domain
Принимать входные данные из конвейера?	false
Принимать подстановочные знаки?	false

-PassThru

Возвращает результаты выполнения команды. По умолчанию этот командлет не формирует никаких выходных данных.

Обязательно?	false
Позиция?	named
Значение по умолчанию
Принимать входные данные из конвейера?	false
Принимать подстановочные знаки?	false

-Server <string>

Задает имя контроллера домена, выполняющего добавление компьютера в домен. Введите имя в формате DomainName\ComputerName. По умолчанию используется значение "Локальный компьютер".

Обязательно?	false
Позиция?	named
Значение по умолчанию
Принимать входные данные из конвейера?	false
Принимать подстановочные знаки?	false

-Unsecure

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

Обязательно?	false
Позиция?	named
Значение по умолчанию
Принимать входные данные из конвейера?	false
Принимать подстановочные знаки?	false

-WorkGroupName <string>

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

Обязательно?	true
Позиция?	3
Значение по умолчанию
Принимать входные данные из конвейера?	false
Принимать подстановочные знаки?	false

-Confirm

Запрашивает подтверждение перед выполнением команды.

Обязательно?	false
Позиция?	named
Значение по умолчанию
Принимать входные данные из конвейера?	false
Принимать подстановочные знаки?	false

-WhatIf

Описывает, что произойдет при выполнении команды, без ее фактического выполнения.

Обязательно?	false
Позиция?	named
Значение по умолчанию
Принимать входные данные из конвейера?	false
Принимать подстановочные знаки?	false

<CommonParameters>

Данный командлет поддерживает общие параметры -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer и -OutVariable. Дополнительные сведения см. в разделе about_Commonparameters.

Ввод и вывод

Входным типом является тип объектов, которые можно передавать командлету по конвейеру. Возвращаемым типом является тип объектов, возвращаемых командлетом.

Входные данные

Нет

Объекты невозможно передать командлету Add-Computer по конвейеру.

Выходные данные

Microsoft.PowerShell.Commands.ComputerChangeInfo

Если задан параметр PassThru, командлет Add-Computer возвращает объект ComputerChangeInfo. В противном случае этот командлет не формирует никаких выходных данных.

Пример 1

C:\PS>add-computer -domainname Domain01; restart-computer

Описание
-----------
Эти команды добавляют локальный компьютер в домен Domain01, используя учетные данные текущего пользователя.

Первая команда добавляет компьютер в домен. Вторая команда использует командлет Restart-Computer для перезапуска компьютера, что завершает операцию присоединения. Точка с запятой (;) разделяет две команды.

Пример 2

C:\PS>add-computer -workgroupname WORKGROUP-A

Описание
-----------
Эта команда добавляет локальный компьютер в рабочую группу Workgroup-A.

Пример 3

C:\PS>add-computer -DomainName Domain01 -Server Domain01\DC01 -passthru -verbose

Описание
-----------
Эта команда добавляет локальный компьютер в домен Domain01 при помощи контроллера домена Domain01\DC01. 

В команде используются параметры PassThru и Verbose для получения подробных сведений о результатах выполнения команды.

Пример 4

C:\PS>Add-Computer -domainname Domain02 -OUPath OU=testOU,DC=domain,DC=Domain,DC=com

Описание
-----------
Эта команда добавляет компьютеры Server01 и Server02 в домен Domain02. Для задания подразделения для новых учетных записей используется параметр OUPath.

Пример 5

C:\PS>Add-Computer -domainname Domain02 -cred Domain02\Admin02 -passthru

Описание
-----------
Эта команда добавляет локальный компьютер в домен Domain02, используя учетные данные администратора домена. В команде используется параметр PassThru для формирования краткого отчета о результатах выполнения команды.

Add-Computer