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

Вы можете передать имена компьютеров в этот командлет.

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

ComputerChangeInfo

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

Примечания

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