Удаление локального компьютера из домена или рабочей группы.
Синтаксис
Remove-Computer [[-Credential] <PSCredential>] [-Force] [-PassThru] [-Confirm] [-WhatIf] [<CommonParameters>]
Описание
Командлет Remove-Computer удаляет локальный компьютер из его текущей рабочей группы или домена.
При удалении компьютера из домена командлет Remove-Computer также отключает учетную запись домена для этого компьютера.
Если компьютер находится в домене, необходимо указать учетные данные, даже если они являются учетными данными текущего пользователя, и перезагрузить компьютер для вступления изменений в силу.
Для получения результатов выполнения команды используются параметры Verbose и PassThru.
Параметры
-Credential <PSCredential>
Задает учетную запись пользователя, который располагает разрешением для выполнения этого действия. По умолчанию используется значение "Текущий пользователь".
Введите имя пользователя, например "User01" или "Domain01\User01", или введите объект PSCredential, например объект, создаваемый командлетом Get-Credential. При вводе имени пользователя система запросит пароль.
Чтобы удалить компьютер из домена, необходимо использовать параметр Credential даже в случае использования учетных данных текущего пользователя.
Обязательно? |
false |
Позиция? |
2 |
Значение по умолчанию |
The credentials of the current user |
Принимать входные данные из конвейера? |
false |
Принимать подстановочные знаки? |
false |
-Force
Обязательно? |
false |
Позиция? |
named |
Значение по умолчанию |
|
Принимать входные данные из конвейера? |
false |
Принимать подстановочные знаки? |
false |
-PassThru
Возвращает результаты выполнения команды. В противном случае этот командлет не формирует никаких выходных данных.
Обязательно? |
false |
Позиция? |
named |
Значение по умолчанию |
|
Принимать входные данные из конвейера? |
false |
Принимать подстановочные знаки? |
false |
-Confirm
Запрашивает подтверждение перед выполнением команды.
Обязательно? |
false |
Позиция? |
named |
Значение по умолчанию |
|
Принимать входные данные из конвейера? |
false |
Принимать подстановочные знаки? |
false |
-WhatIf
Описывает, что произойдет при выполнении команды, без ее фактического выполнения.
Обязательно? |
false |
Позиция? |
named |
Значение по умолчанию |
|
Принимать входные данные из конвейера? |
false |
Принимать подстановочные знаки? |
false |
<CommonParameters>
Данный командлет поддерживает общие параметры -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer и -OutVariable. Дополнительные сведения см. в разделе about_Commonparameters.
Ввод и вывод
Входным типом является тип объектов, которые можно передавать командлету по конвейеру. Возвращаемым типом является тип объектов, возвращаемых командлетом.
Входные данные |
Нет Передать входные данные этому командлету по конвейеру невозможно. |
Выходные данные |
Microsoft.PowerShell.Commands.ComputerChangeInfo Если задан параметр PassThru, командлет Remove-Computer возвращает объект ComputerChangeInfo. В противном случае этот командлет не формирует никаких выходных данных. |
Пример 1
C:\PS>remove-computer Описание ----------- Эта команда удаляет компьютер из рабочей группы.
Пример 2
C:\PS>remove-computer -credential domain01\admin01 -passthru -verbose; restart-computer Описание ----------- Эти команды удаляют локальный компьютер из домена, к которому он присоединен. Первая команда удаляет компьютер из домена. Параметр Credential используется в команде для предоставления учетных данных администратора домена. Параметр PassThru и общий параметр Verbose используются для отображения информации об успешном или неудачном выполнении команды. Вторая команда использует командлет Restart-Computer для перезапуска компьютера, что необходимо для завершения операции удаления. Точка с запятой (;) разделяет две команды.