Remove-Computer
Удаляет локальный компьютер из его домена.
Синтаксис
Remove-Computer
[[-UnjoinDomainCredential] <PSCredential>]
[-Restart]
[-Force]
[-PassThru]
[-WorkgroupName <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remove-Computer
-UnjoinDomainCredential <PSCredential>
[-LocalCredential <PSCredential>]
[-Restart]
[-ComputerName <String[]>]
[-Force]
[-PassThru]
[-WorkgroupName <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Описание
Командлет Remove-Computer
удаляет локальный компьютер и удаленные компьютеры из текущих доменов.
При удалении компьютера из домена Remove-Computer
также отключает учетную запись домена компьютера. Необходимо предоставить явные учетные данные, чтобы отсоединить компьютер от своего домена, даже если они являются учетными данными текущего пользователя. Чтобы внести изменения в силу, необходимо перезапустить компьютер. При удалении компьютера из домена необходимо переместить его в рабочую группу. Используйте параметр WorkgroupName, чтобы указать рабочую группу.
Чтобы переместить компьютер из рабочей группы в домен, из одной рабочей группы в другую или из одного домена в другой, используйте Add-Computer
командлет.
Чтобы получить результаты команды, используйте параметры Verbose и 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 и локальный компьютер из доменов и добавляет их в локальную рабочую группу.
Remove-Computer -ComputerName "Server01", "localhost" -UnjoinDomainCredential Domain01\Admin01 -WorkgroupName "Local" -Restart -Force
Параметр Force подавляет запрос подтверждения для каждого компьютера. Параметр перезапуска перезагрузит компьютеры, чтобы внести изменения в силу.
Параметры
-ComputerName
Указывает компьютеры, удаляемые из своих доменов. По умолчанию используется локальный компьютер.
Введите имя NetBIOS, IP-адрес или полное доменное имя (FQDN) удаленных компьютеров. Чтобы указать локальный компьютер, введите имя компьютера, точку (.
) или localhost
.
Этот параметр не зависит от удаленного взаимодействия PowerShell. Параметр ComputerNameRemove-Computer
можно использовать даже в том случае, если компьютер не настроен для выполнения удаленных команд.
Этот параметр появился в PowerShell 3.0.
Type: | String[] |
Position: | Named |
Default value: | None |
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 |
-Force
Скрывает запрос к пользователю. По умолчанию Remove-Computer
запрашивается подтверждение перед удалением каждого компьютера.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-LocalCredential
Указывает учетную запись пользователя, которая имеет разрешение на подключение к компьютерам, которые указывает параметр ComputerName . По умолчанию используется текущий пользователь.
Введите имя пользователя, например User01
или Domain01\User01
или введите объект PSCredential , например, созданный командлетом Get-Credential
. При вводе имени пользователя командлет запрашивает пароль. Чтобы указать учетную запись пользователя, которая имеет разрешение на удаление компьютера из текущего домена, используйте параметр UnjoinDomainCredential .
Этот параметр появился в PowerShell 3.0.
Type: | PSCredential |
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
Указывает, что этот командлет перезагрузит удаленные компьютеры. Чтобы изменения вступили в силу, часто требуется перезагрузка.
Этот параметр появился в PowerShell 3.0.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UnjoinDomainCredential
Указывает учетную запись пользователя, имеющую разрешение на удаление компьютеров из текущих доменов. Требуются явные учетные данные, как указано в этом параметре, для удаления удаленных компьютеров из домена, даже если это учетные данные текущего пользователя.
Введите имя пользователя, например User01
или Domain01\User01
или введите объект PSCredential , например один из созданных Get-Credential
. При вводе имени пользователя этот командлет запрашивает пароль.
Чтобы указать учетную запись пользователя, которая имеет разрешение на подключение к удаленным компьютерам, используйте параметр LocalCredential .
Этот параметр появился в PowerShell 3.0.
Type: | PSCredential |
Aliases: | Credential |
Position: | 0 |
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. При удалении компьютера из домена необходимо добавить его в рабочую группу.
Этот параметр появился в PowerShell 3.0.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Входные данные
Вы можете передать имена компьютеров в этот командлет.
Выходные данные
При использовании параметра Remove-Computer
PassThru возвращает объект ComputerChangeInfo.
В противном случае командлет не формирует никаких выходных данных.
Примечания
Этот командлет не удаляет компьютеры из рабочих групп.
Связанные ссылки
PowerShell