通过

Remove-Computer

模块:
Microsoft.PowerShell.Management

从其域中删除本地计算机。

语法

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>]

说明

该 Remove-Computer cmdlet 从其当前域中删除本地计算机和远程计算机。

从域中删除计算机时， 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 所有计算机，并将其移动到 Legacy 工作组中。

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。

此参数是在 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 or Domain01\User01），或输入 PSCredential 对象（如 cmdlet 生成的 Get-Credential 对象）。 如果键入用户名，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 运行时会发生什么情况。 命令脚本未运行。

类型:SwitchParameter
别名:wi
Position:Named
默认值:False
必需:False
接受管道输入:False
接受通配符:False

-WorkgroupName

指定从其域中删除计算机时将添加到的工作组的名称。 默认值为 WORKGROUP。 从域中删除计算机时，必须将其添加到工作组。

此参数是在 PowerShell 3.0 中引入的。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

输入

String

您可以通过管道将计算机名称传递给 thiscmdlet。

输出

ComputerChangeInfo

使用 PassThru 参数时，Remove-Computer 返回 ComputerChangeInfo 对象。 否则，此 cmdlet 不会生成任何输出。

备注

此 cmdlet 不会从工作组中删除计算机。