反馈

Rename-Computer

  • 参考
模块:
Microsoft.PowerShell.Management

重命名计算机。

语法

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

说明

此 cmdlet 仅在 Windows 平台上可用。

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

此 cmdlet 是在 Windows PowerShell 3.0 中引入的。

示例

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

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

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

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

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

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

Force 参数取消确认提示。

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

参数

-ComputerName

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

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

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

Type:String
Position:Named
Default value:Local Computer
Accept pipeline input:True
Accept wildcard characters:False
-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False
-DomainCredential

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

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

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

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

Type:PSCredential
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Force

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

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-LocalCredential

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

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

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

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

Type:PSCredential
Position:Named
Default value:Current User
Accept pipeline input:False
Accept wildcard characters:False
-NewName

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

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

Type:String
Position:0
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-PassThru

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

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Restart

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

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-WhatIf

显示在此 cmdlet 运行的情况下将会发生什么。 此 cmdlet 未运行。

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False
-WsmanAuthentication

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

  • 基本
  • CredSSP
  • Default
  • 摘要式
  • Kerberos
  • Negotiate

默认值为 Default。

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

警告

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

已在 Windows PowerShell 3.0 中引入了此参数。

Type:String
Accepted values:Default, Basic, Negotiate, CredSSP, Digest, Kerberos
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

输入

None

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

输出

ComputerChangeInfo

如果指定 PassThru 参数，此 cmdlet 将返回 ComputerChangeInfo 对象。 否则，将不返回任何输出。

备注

此 cmdlet 仅在 Windows 平台上可用。