当前位置:网站首页 > 更多 > 玩电脑 > 正文

[玩转系统] Rename-Computer (Microsoft.PowerShell.Management)

作者:精品下载站 日期:2024-12-14 02:11:24 浏览:14 分类:玩电脑

Rename-Computer (Microsoft.PowerShell.Management)


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 平台。

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

此 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-ComputerComputerName 参数。

类型 :

String

位置:

命名

默认值:

本地计算机

必需的:

False

接受管道输入:

True

接受通配符:

False

-Confirm

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

类型 :

SwitchParameter

别名:

cf

位置:

命名

默认值:

False

必需的:

False

接受管道输入:

False

接受通配符:

False

-DomainCredential

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

键入用户名,例如 User01Domain01\User01,或输入 PSCredential 对象,例如由 Get 生成的对象-Credential cmdlet。

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

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

类型 :

PS凭证

位置:

命名

默认值:

None

必需的:

False

接受管道输入:

False

接受通配符:

False

-Force

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

类型 :

SwitchParameter

位置:

命名

默认值:

None

必需的:

False

接受管道输入:

False

接受通配符:

False

-LocalCredential

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

键入用户名,例如 User01Domain01\User01,或输入 PSCredential 对象,例如由 Get 生成的对象-Credential cmdlet。

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

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

类型 :

PS凭证

位置:

命名

默认值:

当前用户

必需的:

False

接受管道输入:

False

接受通配符:

False

-NewName

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

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

类型 :

String

位置:

0

默认值:

None

必需的:

True

接受管道输入:

True

接受通配符:

False

-PassThru

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

类型 :

SwitchParameter

位置:

命名

默认值:

None

必需的:

False

接受管道输入:

False

接受通配符:

False

-Restart

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

类型 :

SwitchParameter

位置:

命名

默认值:

None

必需的:

False

接受管道输入:

False

接受通配符:

False

-WhatIf

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

类型 :

SwitchParameter

别名:

wi

位置:

命名

默认值:

False

必需的:

False

接受管道输入:

False

接受通配符:

False

-WsmanAuthentication

指定当此 cmdlet 使用 WSMan 协议时用于验证用户凭据的机制。该参数可接受的值为:

  • 基本
  • CredSSP
  • 默认
  • 摘要
  • Kerberos
  • 谈判

默认值为默认

有关此参数值的更多信息,请参阅 AuthenticationMechanism 枚举。

警告

凭据安全服务提供商 (CredSSP) 身份验证将用户凭据传递到远程计算机进行身份验证,专为需要对多个资源进行身份验证的命令(例如访问远程网络共享)而设计。这种机制增加了远程操作的安全风险。如果远程计算机受到威胁,则传递给它的凭据可用于控制网络会话。

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

类型 :

String

接受的值:

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

位置:

命名

默认值:

None

必需的:

False

接受管道输入:

False

接受通配符:

False

输入

此 cmdlet 没有按值获取输入的参数。但是,您可以将对象的 ComputerNameNewName 属性值通过管道传输到此 cmdlet。

输出

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

重命名ComputerChangeInfo

当您使用 PassThru 参数时,此 cmdlet 将返回 RenameComputerChangeInfo 对象。

笔记

此 cmdlet 仅适用于 Windows 平台。

您需要 登录账户 后才能发表评论

取消回复欢迎 发表评论:

关灯