Remove-Computer

從工作群組或網域中移除本機電腦。

語法

Remove-Computer [[-Credential] <PSCredential>] [-Force] [-PassThru] [-Confirm] [-WhatIf] [<CommonParameters>]

描述

Remove-Computer Cmdlet 會從目前的工作群組或網域中移除本機電腦。

從網域中移除電腦時，Remove-Computer 也會停用電腦的網域帳戶。

電腦位於網域中時，您必須提供認證 (即使這些認證屬於目前使用者的認證)，而且必須重新啟動電腦，變更才會生效。

若要取得命令的結果，請使用 Verbose 與 PassThru 這兩個參數。

參數

-Credential <PSCredential>

指定具有執行此動作之權限的使用者帳戶。預設為目前使用者。

請輸入使用者名稱，例如 "User01" 或 "Domain01\User01"，或是輸入 PSCredential 物件，例如由 Get-Credential Cmdlet 所產生的物件。如果輸入使用者名稱，則系統會提示您提供密碼。

若要從網域中移除電腦，即使您使用的是目前使用者的認證，仍然必須使用 Credential 參數。

必要?	false
位置?	2
預設值	目前的使用者憑證
接受管線輸入?	false
接受萬用字元?	false

-Force

必要?	false
位置?	named
預設值
接受管線輸入?	false
接受萬用字元?	false

-PassThru

傳回命令的結果。否則，這個 Cmdlet 不會產生任何輸出。

必要?	false
位置?	named
預設值
接受管線輸入?	false
接受萬用字元?	false

-Confirm

在執行命令前先提示確認。

必要?	false
位置?	named
預設值
接受管線輸入?	false
接受萬用字元?	false

-WhatIf

說明執行命令時將會發生何種情況，但不會實際執行命令。

必要?	false
位置?	named
預設值
接受管線輸入?	false
接受萬用字元?	false

<CommonParameters>

這個 Cmdlet 支援一般參數：-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer 和 -OutVariable。如需詳細資訊，請參閱 about_Commonparameters.

輸入和輸出

輸入型別是可經由管道輸出至 Cmdlet 的物件型別。傳回型別則是 Cmdlet 所傳回的物件型別。

輸入	無 您無法經由管道將輸入輸出至這個 Cmdlet。
輸出	Microsoft.PowerShell.Commands.ComputerChangeInfo 當您使用 PassThru 參數時，Remove-Computer 會傳回 ComputerChangeInfo 物件。否則，這個 Cmdlet 不會產生任何輸出。

範例 1

C:\PS>remove-computer

描述
-----------
這個命令會從工作群組中移除此電腦。

範例 2

C:\PS>remove-computer -credential domain01\admin01 -passthru -verbose; restart-computer

描述
-----------
這些命令會從本機電腦所加入的網域中移除本機電腦。

第一個命令會從網域中移除此電腦。這個命令使用 Credential 參數將認證提供給網域系統管理員。此命令會使用 PassThru 參數和 Verbose 一般參數來顯示有關命令執行成功或失敗的資訊。

第二個命令會使用 Restart-Computer Cmdlet 重新啟動電腦，這是完成移除作業所需的動作。

分號 (;) 會分隔兩個命令。

請參閱

概念

Add-Computer
Checkpoint-Computer
Remove-Computer
Restart-Computer
Restore-Computer
Stop-Computer
Test-Connection