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