Add-Computer
Добавляет локальный компьютер в домен или рабочую группу.
Синтаксис
Add-Computer
[-ComputerName <String[]>]
[-LocalCredential <PSCredential>]
[-UnjoinDomainCredential <PSCredential>]
-Credential <PSCredential>
[-DomainName] <String>
[-OUPath <String>]
[-Server <String>]
[-Unsecure]
[-Options <JoinOptions>]
[-Restart]
[-PassThru]
[-NewName <String>]
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]Add-Computer
[-ComputerName <String[]>]
[-LocalCredential <PSCredential>]
[-Credential <PSCredential>]
[-WorkgroupName] <String>
[-Restart]
[-PassThru]
[-NewName <String>]
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]Описание
Командлет Add-Computer добавляет локальный компьютер или удаленные компьютеры в домен или рабочую группу или перемещает их из одного домена в другой. Он также создает учетную запись домена при добавлении компьютера в домен без учетной записи.
Параметры этого командлета можно использовать для указания контроллера домена и подразделения или выполнения незащищенного присоединения.
Чтобы получить результаты команды, используйте параметры Verbose и PassThru .
Примеры
Пример 1. Добавление локального компьютера в домен, а затем перезагрузка компьютера
Add-Computer -DomainName Domain01 -RestartЭта команда добавляет локальный компьютер в домен Domain01, а затем перезагружает компьютер, чтобы изменения вступили в силу.
Пример 2. Добавление локального компьютера в рабочую группу
Add-Computer -WorkgroupName WORKGROUP-AЭта команда добавляет локальный компьютер в рабочую группу Workgroup-A.
Пример 3. Добавление локального компьютера в домен
Add-Computer -DomainName Domain01 -Server Domain01\DC01 -PassThru -VerboseЭта команда добавляет локальный компьютер в домен Domain01, используя контроллер домена Domain01\DC01.
Команда использует параметры PassThru и Verbose для получения подробных сведений о результатах команды.
Пример 4. Добавление локального компьютера в домен с помощью параметра OUPath
Add-Computer -DomainName Domain02 -OUPath "OU=testOU,DC=domain,DC=Domain,DC=com"Эта команда добавляет локальный компьютер в домен Domain02. Она использует параметр OUPath, чтобы указать подразделение для новых учетных записей.
Пример 5. Добавление локального компьютера в домен с помощью учетных данных
Add-Computer -ComputerName Server01 -LocalCredential Server01\Admin01 -DomainName Domain02 -Credential Domain02\Admin02 -Restart -ForceЭта команда добавляет компьютер Server01 в домен Domain02. Он использует параметр LocalCredential для указания учетной записи пользователя, которая имеет разрешение на подключение к компьютеру Server01. Он использует параметр Credential для указания учетной записи пользователя, которая имеет разрешение на присоединение компьютеров к домену. Он использует параметр перезапуска для перезапуска компьютера после завершения операции соединения и параметра Force для подавления сообщений подтверждения пользователей.
Пример 6. Перемещение группы компьютеров в новый домен
Add-Computer -ComputerName Server01, Server02, localhost -DomainName Domain02 -LocalCredential Domain01\User01 -UnjoinDomainCredential Domain01\Admin01 -Credential Domain02\Admin01 -RestartЭта команда перемещает компьютеры Server01 и Server02 и локальный компьютер из Domain01 в Domain02.
Он использует параметр LocalCredential , чтобы указать учетную запись пользователя, которая имеет разрешение на подключение к трем затронутым компьютерам. Он использует параметр UnjoinDomainCredential , чтобы указать учетную запись пользователя, которая имеет разрешение на объединение компьютеров из домена Domain01 и параметра Credential , чтобы указать учетную запись пользователя, которая имеет разрешение на присоединение компьютеров к домену Domain02. Он использует параметр перезапуска для перезапуска всех трех компьютеров после завершения перемещения.
Пример 7. Перемещение компьютера в новый домен и изменение имени компьютера
Add-Computer -ComputerName Server01 -DomainName Domain02 -NewName Server044 -Credential Domain02\Admin01 -RestartЭта команда перемещает компьютер Server01 в домен Domain02 и изменяет имя компьютера на Server044.
Команда использует учетные данные текущего пользователя для подключения к компьютеру Server01 и исключению его из текущего домена. Он использует параметр Credential для указания учетной записи пользователя, которая имеет разрешение на присоединение компьютера к домену Domain02.
Пример 8. Добавление компьютеров, перечисленных в файле в новый домен
Add-Computer -ComputerName (Get-Content Servers.txt) -DomainName Domain02 -Credential Domain02\Admin02 -Options Win9xUpgrade -RestartЭта команда добавляет компьютеры, перечисленные в файле, в Servers.txt домен Domain02. Он использует параметр Options для указания параметра Win9xUpgrade . Параметр перезапуска перезагрузит все только что добавленные компьютеры после завершения операции соединения.
Пример 9. Добавление компьютера в домен с помощью предопределенных учетных данных компьютера
Эта первая команда должна выполняться администратором с компьютера, который уже присоединен к домену Domain03:
New-ADComputer -Name "Server02" -AccountPassword (ConvertTo-SecureString -String 'TempJoinPA$$' -AsPlainText -Force)
# Then this command is run from `Server02` which is not yet domain-joined:
$joinCred = New-Object pscredential -ArgumentList ([pscustomobject]@{
UserName = $null
Password = (ConvertTo-SecureString -String 'TempJoinPA$$' -AsPlainText -Force)[0]
})
Add-Computer -Domain "Domain03" -Options UnsecuredJoin,PasswordPass -Credential $joinCredЭта комбинация команд создает новую учетную запись компьютера с предопределенным именем и паролем временного соединения в домене с использованием существующего присоединенного к домену компьютера. Затем отдельно компьютер с предопределенным именем присоединяется к домену, используя только имя компьютера и пароль временного соединения. Предопределенный пароль используется только для поддержки операции соединения и заменяется как часть обычных процедур учетной записи компьютера после завершения соединения.
Параметры
-ComputerName
Указывает компьютеры для добавления в домен или рабочую группу. По умолчанию используется локальный компьютер.
Введите NetBIOS-имя, IP-адрес или полное доменное имя каждого из удаленных компьютеров. Чтобы указать локальный компьютер, введите имя компьютера, точку (.) или localhost.
Этот параметр не зависит от удаленного взаимодействия Windows PowerShell. Параметр ComputerNameAdd-Computer можно использовать даже в том случае, если компьютер не настроен для выполнения удаленных команд.
Этот параметр впервые появился в Windows PowerShell 3.0.
| Type: | String[] |
| Position: | Named |
| Default value: | Local computer |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Confirm
Запрос подтверждения перед выполнением командлета.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Credential
Указывает учетную запись пользователя, имеющую разрешение на присоединение компьютеров к новому домену. По умолчанию используется текущий пользователь.
Введите имя пользователя, например User01 или Domain01\User01, или введите объект PSCredential , например один, созданный командлетом Get-Credential . При вводе имени пользователя запрашивается пароль.
Чтобы указать учетную запись пользователя, которая имеет разрешение на удаление компьютера из текущего домена, используйте параметр UnjoinDomainCredential . Чтобы указать учетную запись пользователя, которая имеет разрешение на подключение к удаленному компьютеру, используйте параметр LocalCredential .
| Type: | PSCredential |
| Aliases: | DomainCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DomainName
Указывает домен, в который добавляются компьютеры. Этот параметр является обязательным при добавлении компьютеров в домен.
| Type: | String |
| Aliases: | DN, Domain |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Force
Отключает запрос подтверждения пользователя. Без этого параметра Add-Computer требуется подтвердить добавление каждого компьютера.
Этот параметр впервые появился в Windows PowerShell 3.0.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-LocalCredential
Указывает учетную запись пользователя, которая имеет разрешение на подключение к компьютерам, указанным параметром ComputerName . По умолчанию используется текущий пользователь.
Введите имя пользователя, например User01 или Domain01\User01, или введите объект PSCredential , например один, созданный командлетом Get-Credential . При вводе имени пользователя запрашивается пароль.
Чтобы указать учетную запись пользователя с разрешением на добавление компьютеров в новый домен, используйте параметр Credential . Чтобы указать учетную запись пользователя, которая имеет разрешение на удаление компьютеров из текущего домена, используйте параметр UnjoinDomainCredential .
Этот параметр впервые появился в Windows PowerShell 3.0.
| Type: | PSCredential |
| Position: | Named |
| Default value: | Current user |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-NewName
Указывает новое имя для компьютера в новом домене. Этот параметр допустим только при добавлении или перемещении одного компьютера.
Этот параметр впервые появился в Windows PowerShell 3.0.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Options
Задает дополнительные параметры для Add-Computer операции соединения. Введите одно или несколько значений в строку с разделителями запятыми.
Допустимые значения для этого параметра:
AccountCreate: создает учетную запись домена. Командлет
Add-Computerавтоматически создает учетную запись домена при добавлении компьютера в домен. Этот параметр включен для полноты.Win9XUpgrade: указывает, что операция соединения является частью обновления операционной системы Windows.
UnsecuredJoin: выполняет незащищенное соединение. Чтобы запросить незащищенное соединение, используйте параметр Unsecure или этот параметр. Если вы хотите передать пароль компьютера, этот параметр необходимо использовать в сочетании с
PasswordPassпараметром.PasswordPass: задает пароль компьютера для значения параметра Credential(DomainCredential) после выполнения незащищенного соединения. Этот параметр также указывает, что значение параметра Credential (DomainCredential) является паролем компьютера, а не паролем пользователя. Этот параметр действителен только при указании
UnsecuredJoinпараметра. При использовании этого параметра учетные данные, предоставленные-Credentialпараметру , должны иметь пустое имя пользователя.JoinWithNewName: переименовывает имя компьютера в новом домене в имя, указанное параметром NewName . При использовании параметра NewName этот параметр устанавливается автоматически. Этот параметр предназначен для использования с командлетом Rename-Computer. Если вы используете
Rename-Computerкомандлет для переименования компьютера, но не перезагрузите компьютер, чтобы внести изменения в силу, этот параметр можно использовать для присоединения компьютера к домену с новым именем.JoinReadOnly: использует существующую учетную запись компьютера для присоединения компьютера к контроллеру домена только для чтения. Учетная запись компьютера должна быть добавлена в список разрешенных паролей для политики реплика tion, а пароль учетной записи должен быть реплика в контроллер домена только для чтения перед операцией соединения.
InstallInvoke: задает флаги создания (0x2) и удаления (0x4) параметра FJoinOptions метода JoinDomainOrWorkgroup. Дополнительные сведения о методе JoinDomainOrWorkgroup см. в методе JoinDomainOrWorkgroup класса Win32_ComputerSystem. Дополнительные сведения об этих параметрах см . в функции NetJoinDomain.
Этот параметр впервые появился в Windows PowerShell 3.0.
| Type: | JoinOptions |
| Accepted values: | AccountCreate, Win9XUpgrade, UnsecuredJoin, PasswordPass, DeferSPNSet, JoinWithNewName, JoinReadOnly, InstallInvoke |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OUPath
Указывает подразделение для учетной записи домена. Введите полное различающееся имя подразделения в кавычках. Значение по умолчанию — подразделение по умолчанию для объектов компьютеров в домене.
| Type: | String |
| Aliases: | OU |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PassThru
Возвращает объект, представляющий элемент, с которым вы работаете. По умолчанию этот командлет не создает выходные данные.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Restart
Перезапускает компьютеры, которые были добавлены в домен или рабочую группу. Чтобы изменения вступили в силу, часто требуется перезагрузка.
Этот параметр впервые появился в Windows PowerShell 3.0.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Server
Задает имя контроллера домена, который добавляет компьютер в домен. Введите имя в формате "ИмяДомена\ИмяКомпьютера". По умолчанию контроллер домена не указан.
| Type: | String |
| Aliases: | DC |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UnjoinDomainCredential
Указывает учетную запись пользователя, имеющую разрешение на удаление компьютеров из текущих доменов. По умолчанию используется текущий пользователь.
Введите имя пользователя, например User01 или Domain01\User01, или введите объект PSCredential , например один, созданный командлетом Get-Credential . При вводе имени пользователя запрашивается пароль.
Используйте этот параметр при перемещении компьютеров в другой домен. Чтобы указать учетную запись пользователя, которая имеет разрешение на присоединение к новому домену, используйте параметр Credential . Чтобы указать учетную запись пользователя, которая имеет разрешение на подключение к удаленному компьютеру, используйте параметр LocalCredential .
Этот параметр впервые появился в Windows PowerShell 3.0.
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Unsecure
Выполняет незащищенное присоединение к указанному домену.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
Показывает, что произойдет при запуске командлета. Командлет не выполняется.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WorkgroupName
Указывает имя рабочей группы, в которую добавляются компьютеры. Значение по умолчанию — WORKGROUP.
| Type: | String |
| Aliases: | WGN |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Входные данные
Имена компьютеров и новые имена можно передать командлету Add-Computer .
Выходные данные
При использовании параметра Add-Computer PassThru возвращает объект ComputerChangeInfo.
В противном случае командлет не формирует никаких выходных данных.
Примечания
- В Windows PowerShell 2.0 параметр
Add-Computerсервера завершается ошибкой, даже если сервер присутствует. В Windows PowerShell 3.0 реализация параметра Сервера изменяется таким образом, чтобы он работал надежно.
Связанные ссылки
PowerShell
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по