Remove-Computer
從其網域中移除本機計算機。
語法
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>]
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
的 ComputerName 參數。
此參數是在 PowerShell 3.0 中引進的。
類型: | String[] |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | True |
接受萬用字元: | False |
-Confirm
在執行 Cmdlet 之前,提示您進行確認。
類型: | SwitchParameter |
別名: | cf |
Position: | Named |
預設值: | False |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-Force
隱藏使用者提示。 根據預設,Remove-Computer
會在移除每部計算機之前提示您確認。
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-LocalCredential
指定有權連線到 ComputerName 參數所指定之電腦的用戶帳戶。 預設值為目前的使用者。
輸入使用者名稱,例如 User01
或 Domain01\User01
,或輸入 PSCredential 物件,例如 Get-Credential
Cmdlet 所產生的用戶名稱。 如果您輸入用戶名稱,Cmdlet 會提示您輸入密碼。 若要指定有權從目前網域移除計算機的用戶帳戶,請使用 UnjoinDomainCredential 參數。
此參數是在 PowerShell 3.0 中引進的。
類型: | PSCredential |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-PassThru
傳回命令的結果。 否則,此 Cmdlet 不會產生任何輸出。
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-Restart
表示此 Cmdlet 會重新啟動要移除的電腦。 通常需要重新啟動才能使變更生效。
此參數是在 PowerShell 3.0 中引進的。
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-UnjoinDomainCredential
指定具有從目前網域移除計算機許可權的用戶帳戶。 明確認證,如此參數提供,需要從網域移除遠端計算機,即使值是目前使用者的認證也一樣。
輸入使用者名稱,例如 User01
或 Domain01\User01
,或輸入 PSCredential 物件,例如 Get-Credential
所產生的用戶名稱。 如果您輸入使用者名稱,此 Cmdlet 會提示您輸入密碼。
若要指定有權連線到遠端電腦的用戶帳戶,請使用 LocalCredential 參數。
此參數是在 PowerShell 3.0 中引進的。
類型: | PSCredential |
別名: | Credential |
Position: | 0 |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-WhatIf
顯示 Cmdlet 執行時會發生什麼事。 Cmdlet 未執行。
類型: | SwitchParameter |
別名: | wi |
Position: | Named |
預設值: | False |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-WorkgroupName
指定從其網域中移除計算機時,要新增至其中的工作組名稱。 預設值為 WORKGROUP。 當您從網域移除計算機時,必須將電腦新增至工作組。
此參數是在 PowerShell 3.0 中引進的。
類型: | String |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
輸入
您可以使用管線將電腦名稱傳送至此 Cmdlet。
輸出
當您使用 PassThru 參數時,Remove-Computer
會傳回 ComputerChangeInfo 物件。
否則,此 Cmdlet 不會產生任何輸出。
備註
此 Cmdlet 不會從工作組中移除電腦。