通过

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 文件中列出的所有计算机从其域中删除，并将它们移动到旧工作组中。

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 对象，例如由 Get-Credential cmdlet 生成的用户名。 键入用户名时，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 不会从工作组删除计算机。