Remove-Computer
從其網域中移除本機計算機。
語法
Local (預設值)
Remove-Computer
[[-UnjoinDomainCredential] <PSCredential>]
[-Restart]
[-Force]
[-PassThru]
[-WorkgroupName <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remote
Remove-Computer
-UnjoinDomainCredential <PSCredential>
[-LocalCredential <PSCredential>]
[-Restart]
[-ComputerName <String[]>]
[-Force]
[-PassThru]
[-WorkgroupName <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Remove-Computer Cmdlet 會從目前的網域中移除本機計算機和遠端電腦。
當您從網域移除計算機時，Remove-Computer 也會停用計算機的網域帳戶。 您必須提供明確的認證，才能將計算機從其網域取消加入，即使計算機是目前使用者的認證也一樣。 您必須重新啟動計算機，才能讓變更生效。 此外，當您從網域移除計算機時，必須將計算機移至工作組。 使用 WorkgroupName 參數來指定工作組。
若要將計算機從工作組移至網域、從一個工作組移至另一個工作組，或從一個網域移至另一個網域，請使用 Add-Computer Cmdlet。
若要取得命令的結果，請使用 Verbose 和 PassThru 參數。 若要隱藏使用者提示，請使用 Force 參數。
Remove-Computer 從網域移除本機計算機和遠端電腦。 它包含認證參數，可指定連線到遠端計算機的替代認證，以及從網域取消加入、重新啟動 參數，以及指定計算機加入工作組名稱的 WorkgroupName 參數。
範例
範例 1：從其網域移除本機計算機
此範例會從加入的網域中移除本機計算機。
Remove-Computer -UnjoinDomaincredential Domain01\Admin01 -PassThru -Verbose -Restart
UnjoinDomainCredential 參數會提供網域系統管理員的認證。 PassThru 和 Verbose 一般參數會顯示命令成功或失敗的相關信息。 Restart 參數會重新啟動電腦，以完成移除作業。
未指定工作組名稱時，計算機會移至從其網域中移除后命名的工作組。
範例 2：將數部計算機移至舊版工作組
此範例會從其網域中移除 OldServers.txt 檔案中列出的所有計算機，並將其移至舊版 工作組。
Remove-Computer -ComputerName (Get-Content OldServers.txt) -LocalCredential Domain01\Admin01 -UnJoinDomainCredential Domain01\Admin01 -WorkgroupName "Legacy" -Force -Restart
LocalCredential 參數會提供有權連線到遠端電腦的用戶認證。 UnjoinDomainCredential 參數會提供有權從其網域中移除電腦的用戶認證。 Force 參數會隱藏每部計算機的確認提示。 Restart 參數會在從其網域中移除計算機之後重新啟動每部電腦。
範例 3：在不確認的情況下從工作組移除計算機
此範例會從其網域中移除遠端電腦 Server01 和本機計算機，並將其新增至 Local 工作組。
Remove-Computer -ComputerName "Server01", "localhost" -UnjoinDomainCredential Domain01\Admin01 -WorkgroupName "Local" -Restart -Force
Force 參數會隱藏每部計算機的確認提示。 Restart 參數會重新啟動電腦，讓變更生效。
參數
-ComputerName
指定要從其網域中移除的計算機。 預設值為本機電腦。
輸入遠端電腦的 NetBIOS 名稱、IP 位址或完整功能變數名稱 （FQDN）。 若要指定本機計算機，請輸入計算機名稱、點 （.） 或localhost。
此參數不依賴 PowerShell 遠端管理。 即使您的電腦未設定為執行遠端命令，您也可以使用 的 Remove-Computer 參數。
此參數是在 PowerShell 3.0 中引進的。
參數屬性
| 類型: | String[] |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Remote
| Position: | Named |
| 必要: | False |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-Confirm
在執行 Cmdlet 之前，提示您進行確認。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | False |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | cf |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Force
隱藏使用者提示。 根據預設，Remove-Computer 會在移除每部計算機之前提示您確認。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-LocalCredential
指定有權連線到 ComputerName 參數所指定之電腦的用戶帳戶。 預設值為目前的使用者。
鍵入使用者名（如 User01 or Domain01\User01），或輸入 PSCredential 物件（如 cmdlet 生成的 Get-Credential 物件）。 如果您輸入用戶名稱，Cmdlet 會提示您輸入密碼。 若要指定有權從目前網域移除計算機的用戶帳戶，請使用 UnjoinDomainCredential 參數。
此參數是在 PowerShell 3.0 中引進的。
參數屬性
| 類型: | PSCredential |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Remote
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-PassThru
傳回命令的結果。 否則，此 Cmdlet 不會產生任何輸出。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Restart
表示此 Cmdlet 會重新啟動要移除的電腦。 通常需要重新啟動才能使變更生效。
此參數是在 PowerShell 3.0 中引進的。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-UnjoinDomainCredential
指定具有從目前網域移除計算機許可權的用戶帳戶。 明確認證，如此參數提供，需要從網域移除遠端計算機，即使值是目前使用者的認證也一樣。
鍵入使用者名（如 User01 或 Domain01\User01）或輸入 PSCredential 物件（如 生成的 Get-Credential物件）。 如果您輸入使用者名稱，此 Cmdlet 會提示您輸入密碼。
若要指定有權連線到遠端電腦的用戶帳戶，請使用 LocalCredential 參數。
此參數是在 PowerShell 3.0 中引進的。
參數屬性
| 類型: | PSCredential |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | 憑據 |
參數集
Local
| Position: | 0 |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
Remote
| Position: | 0 |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-WhatIf
顯示 Cmdlet 執行時會發生什麼事。 指令未執行。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | False |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | 無線 |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-WorkgroupName
指定從其網域中移除計算機時，要新增至其中的工作組名稱。 預設值為 WORKGROUP。 當您從網域移除計算機時，必須將電腦新增至工作組。
此參數是在 PowerShell 3.0 中引進的。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
CommonParameters
此 Cmdlet 支援一般參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊，請參閱 about_CommonParameters。
輸入
String
您可以通過管道將計算機名稱傳遞給 thiscmdlet。
輸出
ComputerChangeInfo
當您使用 PassThru 參數時，Remove-Computer 會傳回 ComputerChangeInfo 物件。
否則，此 Cmdlet 不會產生任何輸出。
備註
此 Cmdlet 不會從工作組中移除電腦。