使用英语阅读

通过

Rename-Computer

  • 参考
模块:
Microsoft.PowerShell.Management

重命名计算机。

语法

PowerShell 
Rename-Computer
      [-ComputerName <String>]
      [-PassThru]
      [-DomainCredential <PSCredential>]
      [-LocalCredential <PSCredential>]
      [-NewName] <String>
      [-Force]
      [-Restart]
      [-WsmanAuthentication <String>]
      [-Protocol <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

说明

Rename-Computer cmdlet 重命名本地计算机或远程计算机。 它在每个命令中重命名一台计算机。

此 cmdlet 已在 Windows PowerShell 3.0 中引入。

示例

示例 1：重命名本地计算机

此命令将本地计算机重命名为 Server044，然后重新启动它以使更改生效。

PowerShell 
Rename-Computer -NewName "Server044" -DomainCredential Domain01\Admin01 -Restart

示例 2：重命名远程计算机

此命令将 Srv01 计算机重命名为 Server001。 计算机未重启。

DomainCredential 参数指定有权重命名域中计算机的用户的凭据。

Force 参数将取消确认提示。

PowerShell 
Rename-Computer -ComputerName "Srv01" -NewName "Server001" -DomainCredential Domain01\Admin01 -Force

参数

-ComputerName

重命名指定的远程计算机。 默认值为本地计算机。

键入 NetBIOS 名称、IP 地址或远程计算机的完全限定域名。 若要指定本地计算机，请键入计算机名称、点（.）或 localhost。

此参数不依赖于 PowerShell 远程处理。 即使计算机未配置为运行远程命令，也可以使用 Rename-ComputerComputerName 参数。

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

-Confirm

在运行 cmdlet 之前，提示你进行确认。

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

-DomainCredential

指定有权连接到域的用户帐户。 显式凭据需要重命名已加入域的计算机。

键入用户名（如 User01 或 Domain01\User01），或输入 PSCredential 对象，例如由 Get-Credential cmdlet 生成的用户名。

如果键入用户名，此 cmdlet 会提示输入密码。

若要指定有权连接到由 ComputerName 参数指定的计算机的用户帐户，请使用 LocalCredential 参数。

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

-Force

强制命令运行而不要求用户确认。

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

-LocalCredential

指定有权连接到由 ComputerName 参数指定的计算机的用户帐户。 默认值为当前用户。

键入用户名（如 User01 或 Domain01\User01），或输入 PSCredential 对象，例如由 Get-Credential cmdlet 生成的用户名。

如果键入用户名，此 cmdlet 会提示输入密码。

若要指定有权连接到域的用户帐户，请使用 DomainCredential 参数。

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

-NewName

指定计算机的新名称。 此参数是必需的。

标准名称可以包含字母（a-z）、（A-Z）、数字（0-9）和连字符（-），但没有空格或句点（.）。 该名称可能不完全包含数字，并且长度可能不超过 63 个字符

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

-PassThru

返回命令的结果。 否则，此 cmdlet 不会生成任何输出。

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

-Protocol

指定用于重命名计算机的协议。 此参数的可接受值为：WSMan 和 DCOM。 默认值为 DCOM。

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

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

-Restart

指示此 cmdlet 重新启动重命名的计算机。 通常需要重启才能使更改生效。

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

-WhatIf

显示 cmdlet 运行时会发生什么情况。 cmdlet 未运行。

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

-WsmanAuthentication

指定此 cmdlet 使用 WSMan 协议时用于对用户凭据进行身份验证的机制。 此参数的可接受值为：

  • 基本
  • CredSSP
  • 默认
  • 摘要
  • Kerberos
  • 协商

默认值 默认值。

有关此参数的值的详细信息，请参阅 AuthenticationMechanism 枚举。

警告

凭据安全服务提供程序（CredSSP）身份验证（其中用户凭据传递到要进行身份验证的远程计算机）旨在用于需要对多个资源进行身份验证的命令，例如访问远程网络共享。 此机制会增加远程作的安全风险。 如果远程计算机遭到入侵，则传递给它的凭据可用于控制网络会话 >。

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

类型:String
接受的值:Default, Basic, Negotiate, CredSSP, Digest, Kerberos
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

输入

None

此 cmdlet 没有按值输入的参数。 但是，可以通过管道将 ComputerName 的值 NewName 对象属性传递给此 cmdlet。

输出

None

默认情况下，此 cmdlet 不返回任何输出。

RenameComputerChangeInfo

使用 PassThru 参数时，此 cmdlet 将返回 RenameComputerChangeInfo 对象。