Add-Computer
Добавление локального компьютера в домен или рабочую группу.
Синтаксис
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 |
Значение по умолчанию |
Параметры учетной записи текущего пользователя |
Принимать входные данные из конвейера? |
false |
Принимать подстановочные знаки? |
false |
-DomainName <string>
Задает домен для учетной записи компьютера. Это обязательный параметр.
Обязательно? |
true |
Позиция? |
2 |
Значение по умолчанию |
|
Принимать входные данные из конвейера? |
false |
Принимать подстановочные знаки? |
false |
-OUPath <string>
Задает подразделение для учетной записи домена. Введите полное различающееся имя подразделения. По умолчанию используется подразделение, принятое по умолчанию для объектов-компьютеров в домене.
Обязательно? |
false |
Позиция? |
named |
Значение по умолчанию |
Подразделение, принятое по умолчанию для всех объектов-компьютеров в домене |
Принимать входные данные из конвейера? |
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 для формирования краткого отчета о результатах выполнения команды.
См. также
Концепции
Checkpoint-Computer
Remove-Computer
Restart-Computer
Restore-Computer
Stop-Computer
Test-Connection