Remove-Computer

  • 參考
模組:
Microsoft.PowerShell.Management

從其網域中移除本機計算機。

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 遠端處理。 即使您的電腦未設定為執行遠端命令，您也可以使用 的 Remove-Computer ComputerName 參數。

此參數是在 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

輸入

String

您可以使用管線將電腦名稱傳送至此 Cmdlet。

輸出

ComputerChangeInfo

當您使用 PassThru 參數時， Remove-Computer 會傳 回 ComputerChangeInfo 物件。 否則，此 Cmdlet 不會產生任何輸出。

備註

此 Cmdlet 不會從工作組中移除電腦。