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

Синтаксис

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 для формирования краткого отчета о результатах выполнения команды.






См. также




Содержание