Remove-Computer

  • Ссылка
Модуль:
Microsoft.PowerShell.Management

Удаляет локальный компьютер из его домена.

Синтаксис

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

Входные данные

String

Имена компьютеров можно передать в thiscmdlet.

Выходные данные

ComputerChangeInfo

При использовании параметра Remove-ComputerPassThru возвращает объект ComputerChangeInfo. В противном случае командлет не формирует никаких выходных данных.

Примечания

Этот командлет не удаляет компьютеры из рабочих групп.