Rename-Computer
重命名计算机。
语法
Rename-Computer
[-ComputerName <String>]
[-PassThru]
[-DomainCredential <PSCredential>]
[-LocalCredential <PSCredential>]
[-NewName] <String>
[-Force]
[-Restart]
[-WsmanAuthentication <String>]
[-Protocol <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
说明
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 远程处理。
即使计算机未配置为运行远程命令,也可以使用 的 Rename-Computer
ComputerName 参数。
Type: | String |
Position: | Named |
Default value: | Local Computer |
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 |
-DomainCredential
指定有权连接到域的用户帐户。 需要显式凭据才可重命名加入到域的计算机。
键入用户名(如 User01
或 Domain01\User01
),或输入 PSCredential 对象,例如 cmdlet Get-Credential
生成的对象。
键入用户名时,此 cmdlet 会提示输入密码。
若要指定有权连接到由 ComputerName 参数指定的计算机的用户帐户,请使用 LocalCredential 参数。
Type: | PSCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Force
强制运行命令而不要求用户确认。
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-NewName
为计算机指定一个新名称。 此参数是必需的。
标准名称可能包含字母 (a-z
) 、 (A-Z
) 、数字 () 0-9
和连字符 () -
,但) (.
不包含空格或句点。 名称不能完全由数字组成,并且长度不能超过 63 个字符
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-PassThru
返回命令的结果。 否则,此 cmdlet 将不生成任何输出。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Protocol
指定用于重命名计算机的协议。 此参数的可接受的值是:WSMan 和 DCOM。 默认值为 DCOM。
已在 Windows PowerShell 3.0 中引入了此参数。
Type: | String |
Accepted values: | DCOM, WSMan |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Restart
指示此 cmdlet 重启已重命名的计算机。 若要更改生效,通常需要重新启动。
Type: | SwitchParameter |
Position: | Named |
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 |
-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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
输入
None
此 cmdlet 不具有按值获取输入的参数。 但是,你可以通过管道将对象的 ComputerName 和 NewName 属性的值传递给此 cmdlet。
输出
如果指定 PassThru 参数,此 cmdlet 将返回 ComputerChangeInfo 对象。 否则,将不返回任何输出。