Remove-Computer
Удаляет локальный компьютер из своего домена.
Синтаксис
Local (По умолчанию)
Remove-Computer
[[-UnjoinDomainCredential] <PSCredential>]
[-Restart]
[-Force]
[-PassThru]
[-WorkgroupName <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remote
Remove-Computer
-UnjoinDomainCredential <PSCredential>
[-LocalCredential <PSCredential>]
[-Restart]
[-ComputerName <String[]>]
[-Force]
[-PassThru]
[-WorkgroupName <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Описание
Командлет Remove-Computer удаляет локальный компьютер и удаленные компьютеры из текущих доменов.
При удалении компьютера из домена Remove-Computer также отключает учетную запись домена компьютера. Необходимо предоставить явные учетные данные, чтобы отсоединить компьютер от своего домена, даже если они являются учетными данными текущего пользователя. Чтобы внести изменения в силу, необходимо перезапустить компьютер. Кроме того, при удалении компьютера из домена необходимо переместить его в рабочую группу. Используйте параметр WorkgroupName, чтобы указать рабочую группу.
Чтобы переместить компьютер из рабочей группы в домен, из одной рабочей группы в другую или из одного домена в другой, используйте командлет Add-Computer.
Чтобы получить результаты команды, используйте параметры Подробные и PassThru. Чтобы отключить запрос пользователя, используйте параметр Force.
Remove-Computer удаляет локальный компьютер и удаленные компьютеры из доменов. Он включает параметры учетных данных, которые указывают альтернативные учетные данные для подключения к удаленным компьютерам и отмены взаимодействия с доменом, параметр перезапуска для перезапуска затронутых компьютеров, а также параметр WorkgroupName для указания имени рабочей группы, в которую добавляются компьютеры.
Примеры
Пример 1. Удаление локального компьютера из своего домена
В этом примере удаляется локальный компьютер из домена, к которому он присоединен.
Remove-Computer -UnjoinDomaincredential Domain01\Admin01 -PassThru -Verbose -Restart
Параметр UnjoinDomainCredential предоставляет учетные данные администратора домена. PassThru и Подробные общие параметры отображают сведения об успешном выполнении или сбое команды. Параметр перезапуска перезагрузит компьютер, чтобы завершить операцию удаления.
Если имя рабочей группы не указано, компьютер перемещается в рабочую группу с именем после удаления из своего домена.
Пример 2. Перемещение нескольких компьютеров в устаревшую рабочую группу
В этом примере удаляются все компьютеры, перечисленные в файле OldServers.txt из доменов, и перемещаются в рабочую группу прежних версий.
Remove-Computer -ComputerName (Get-Content OldServers.txt) -LocalCredential Domain01\Admin01 -UnJoinDomainCredential Domain01\Admin01 -WorkgroupName "Legacy" -Force -Restart
Параметр LocalCredential предоставляет учетные данные пользователя, имеющего разрешение на подключение к удаленным компьютерам. Параметр UnjoinDomainCredential предоставляет учетные данные пользователя, имеющего разрешение на удаление компьютеров из доменов. Параметр Force подавляет запросы подтверждения для каждого компьютера. Параметр перезапуска перезапускает каждый из компьютеров после удаления из домена.
Пример 3. Удаление компьютеров из рабочей группы без подтверждения
Этот пример удаляет удаленный компьютер, Server01 и локальный компьютер из доменов и добавляет их в рабочую группу Local.
Remove-Computer -ComputerName "Server01", "localhost" -UnjoinDomainCredential Domain01\Admin01 -WorkgroupName "Local" -Restart -Force
Параметр Force подавляет запрос подтверждения для каждого компьютера. Параметр перезапуска перезагрузит компьютеры для эффективного изменения.
Параметры
-ComputerName
Указывает компьютеры, которые нужно удалить из доменов. По умолчанию используется локальный компьютер.
Введите имя NetBIOS, IP-адрес или полное доменное имя (FQDN) удаленных компьютеров. Чтобы указать локальный компьютер, введите имя компьютера, точку (.) или localhost.
Этот параметр не зависит от удаленного управления PowerShell. Можно использовать параметр ComputerNameRemove-Computer, даже если ваш компьютер не настроен для выполнения удаленных команд.
Этот параметр появился в PowerShell 3.0.
Свойства параметров
| Тип: | String[] |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
Remote
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-Confirm
Запрашивает подтверждение перед запуском cmdlet.
Свойства параметров
| Тип: | SwitchParameter |
| Default value: | False |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | cf |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Force
Подавляет запрос пользователя. По умолчанию Remove-Computer запрашивает подтверждение перед удалением каждого компьютера.
Свойства параметров
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-LocalCredential
Указывает учетную запись пользователя, которая имеет разрешение на подключение к компьютерам, которые указывает параметр ComputerName. По умолчанию используется текущий пользователь.
Введите имя пользователя, например User01 или Domain01\User01, или введите объект PSCredential, например один, созданный командлетом Get-Credential. При вводе имени пользователя командлет запрашивает пароль. Чтобы указать учетную запись пользователя, которая имеет разрешение на удаление компьютера из текущего домена, используйте параметр UnjoinDomainCredential.
Этот параметр появился в PowerShell 3.0.
Свойства параметров
| Тип: | PSCredential |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
Remote
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-PassThru
Возвращает результаты команды. В противном случае этот командлет не создает выходные данные.
Свойства параметров
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Restart
Указывает, что этот командлет перезагрузит удаленные компьютеры. Для эффективного изменения часто требуется перезапуск.
Этот параметр появился в PowerShell 3.0.
Свойства параметров
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-UnjoinDomainCredential
Указывает учетную запись пользователя, которая имеет разрешение на удаление компьютеров из текущих доменов. Явные учетные данные, предоставляемые этим параметром, необходимы для удаления удаленных компьютеров из домена, даже если это значение является учетными данными текущего пользователя.
Введите имя пользователя, например User01 или Domain01\User01, или введите объект PSCredential, например один, созданный Get-Credential. При вводе имени пользователя этот командлет запрашивает пароль.
Чтобы указать учетную запись пользователя, которая имеет разрешение на подключение к удаленным компьютерам, используйте параметр LocalCredential.
Этот параметр появился в PowerShell 3.0.
Свойства параметров
| Тип: | PSCredential |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | Подтверждение компетенции |
Наборы параметров
Local
| Position: | 0 |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
Remote
| Position: | 0 |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-WhatIf
Показывает, что произойдет, если командлет будет запущен. Командлет не запускается.
Свойства параметров
| Тип: | SwitchParameter |
| Default value: | False |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | wi |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-WorkgroupName
Указывает имя рабочей группы, в которую добавляются компьютеры при удалении из доменов. Значение по умолчанию — WORKGROUP. При удалении компьютера из домена необходимо добавить его в рабочую группу.
Этот параметр появился в PowerShell 3.0.
Свойства параметров
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
CommonParameters
Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.
Входные данные
String
Вы можете передать имена компьютеров в этот командлет.
Выходные данные
ComputerChangeInfo
При использовании параметра PassThruRemove-Computer возвращает объект ComputerChangeInfo.
В противном случае этот командлет не создает выходные данные.
Примечания
Этот командлет не удаляет компьютеры из рабочих групп.
