Rename-Computer
重命名计算机。
语法
Default （默认值）
Rename-Computer
[-ComputerName <String>]
[-PassThru]
[-DomainCredential <PSCredential>]
[-LocalCredential <PSCredential>]
[-NewName] <String>
[-Force]
[-Restart]
[-WsmanAuthentication <String>]
[-Protocol <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
说明
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 远程处理。
即使计算机未配置为运行远程命令，也可以使用 参数中的 Rename-Computer。
参数属性
| 类型: | String |
| 默认值: | Local Computer |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | True |
| 来自剩余参数的值: | False |
-Confirm
在运行 cmdlet 之前，提示你进行确认。
参数属性
| 类型: | SwitchParameter |
| 默认值: | False |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | cf |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-DomainCredential
指定有权连接到域的用户帐户。 需要显式凭据才可重命名加入到域的计算机。
键入用户名（如 User01 或 Domain01\User01），或输入 PSCredential 对象，例如由 Get-Credential cmdlet 生成的用户名。
如果键入用户名，此 cmdlet 会提示输入密码。
若要指定有权连接到由 ComputerName 参数指定的计算机的用户帐户，请使用 LocalCredential 参数。
参数属性
| 类型: | PSCredential |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Force
强制命令运行而不要求用户确认。
参数属性
| 类型: | SwitchParameter |
| 默认值: | False |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-LocalCredential
指定有权连接到由 ComputerName 参数指定的计算机的用户帐户。 默认值为当前用户。
键入用户名（如 User01 或 Domain01\User01），或输入 PSCredential 对象，例如由 Get-Credential cmdlet 生成的用户名。
如果键入用户名，此 cmdlet 会提示输入密码。
若要指定有权连接到域的用户帐户，请使用 DomainCredential 参数。
参数属性
| 类型: | PSCredential |
| 默认值: | Current User |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-NewName
指定计算机的新名称。 此参数是必需的。
标准名称可以包含字母（a-z）、（A-Z）、数字（0-9）和连字符（-），但没有空格或句点（.）。 该名称可能不完全包含数字，并且长度可能不超过 63 个字符
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | 0 |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | True |
| 来自剩余参数的值: | False |
-PassThru
返回命令的结果。 否则，此 cmdlet 不会生成任何输出。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Protocol
指定用于重命名计算机的协议。 此参数的可接受值为：WSMan 和 DCOM。 默认值为 DCOM。
此参数是在 Windows PowerShell 3.0 中引入的。
参数属性
| 类型: | String |
| 默认值: | None |
| 接受的值: | DCOM, WSMan |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Restart
指示此 cmdlet 重新启动已重命名的计算机。 通常需要重启才能使更改生效。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-WhatIf
显示 cmdlet 运行时会发生什么情况。 命令脚本未运行。
参数属性
| 类型: | SwitchParameter |
| 默认值: | False |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | 无线 |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-WsmanAuthentication
指定此 cmdlet 使用 WSMan 协议时用于对用户凭据进行身份验证的机制。 此参数的可接受值为：
- 基本
- CredSSP
- 默认
- 摘要
- Kerberos
- 协商
默认值是 Default。
有关此参数的值的详细信息，请参阅 AuthenticationMechanism 枚举。
警告
凭据安全服务提供程序（CredSSP）身份验证（其中用户凭据传递到要进行身份验证的远程计算机）旨在用于需要对多个资源进行身份验证的命令，例如访问远程网络共享。 此机制会增加远程操作的安全风险。 如果远程计算机遭到入侵，则传递给它的凭据可用于控制网络会话 >。
此参数是在 Windows PowerShell 3.0 中引入的。
参数属性
| 类型: | String |
| 默认值: | None |
| 接受的值: | Default, Basic, Negotiate, CredSSP, Digest, Kerberos |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
CommonParameters
此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。
输入
None
此 cmdlet 没有按值输入的参数。 但是，可以通过管道将对象的 ComputerName 和 NewName 属性的值传递给此 cmdlet。
输出
ComputerChangeInfo
如果指定 PassThru 参数，此 cmdlet 将返回 ComputerChangeInfo 对象。 否则，将不返回任何输出。