Remove-Computer
將本機電腦從其網域中移除。
Syntax
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
Cmdlet Remove-Computer
會從目前的網域中移除本機計算機和遠端計算機。
當您從網域移除計算機時, Remove-Computer
也會停用計算機的網域帳戶。 您必須提供明確的認證,使其從其網域取消加入計算機,即使這些認證是目前使用者的認證也一樣。 您必須重新啟動計算機,才能讓變更生效。 此外,當您將電腦從網域中移除時,必須將它移到工作群組中。 請使用 WorkgroupName 參數來指定工作群組。
若要將計算機從工作組移至網域、從一個工作組移至另一個工作組,或從一個網域移至另一個網域,請使用 Add-Computer
Cmdlet。
若要取得此命令的結果,請使用 Verbose 和 PassThru 參數。 若要抑制使用者提示,請使用 Force 參數。
Remove-Computer
從網域中移除本機計算機和遠端計算機。 它包含認證參數,用來指定連線到遠端電腦及從網域退出時所要使用的替代認證;Restart參數,用來重新啟動受影響的電腦;以及 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 和本機計算機,並將其新增至 本機 工作組。
Remove-Computer -ComputerName "Server01", "localhost" -UnjoinDomainCredential Domain01\Admin01 -WorkgroupName "Local" -Restart -Force
Force 參數會隱藏每部計算機的確認提示。 Restart 參數會重新啟動計算機,使變更生效。
參數
-ComputerName
指定要從其網域中移除的電腦。 預設是本機電腦。
輸入遠端電腦的 NetBIOS 名稱、IP 位址或完整功能變數名稱 (FQDN) 。 若要指定本機電腦,請輸入電腦名稱、句點 (.),或者 localhost。
此參數不依賴 PowerShell 遠端處理。 即使您的電腦未設定為執行遠端命令,您也可以使用 的 ComputerName 參數 Remove-Computer
。
此參數是在 PowerShell 3.0 中引進。
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Confirm
在執行 Cmdlet 前提示您確認。
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 物件,例如 Cmdlet 所產生的 Get-Credential
名稱。 如果您輸入用戶名稱,Cmdlet 會提示您輸入密碼。 若要指定具有將電腦從其目前網域中移除之權限的使用者帳戶,請使用 UnjoinDomainCredential 參數。
此參數是在 PowerShell 3.0 中引進。
Type: | PSCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PassThru
傳回命令的結果。 否則,此 Cmdlet 不會產生任何輸出。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Restart
指出此 Cmdlet 會重新啟動要移除的電腦。 通常必須重新啟動才能使變更生效。
此參數是在 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
物件。 如果您輸入使用者名稱,此 Cmdlet 會提示您輸入密碼。
若要指定具有連線到遠端電腦之權限的使用者帳戶,請使用 LocalCredential 參數。
此參數是在 PowerShell 3.0 中引進。
Type: | PSCredential |
Aliases: | Credential |
Position: | 0 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
顯示執行 Cmdlet 後會發生的情況。 Cmdlet 並不會執行。
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 |
輸入
您可以使用管線將電腦名稱傳送至 thiscmdlet。
輸出
當您使用 PassThru 參數時, Remove-Computer
會傳回 ComputerChangeInfo 物件。
否則,此 Cmdlet 不會產生任何輸出。
備註
這個 Cmdlet 不會將電腦從工作群組中移除。