Set-HpcNode

模块:

HPC Module

更改节点的属性。

语法

Name （默认值）

Set-HpcNode
    [-Name] <String[]>
    [-Description <String>]
    [-Chassis <String>]
    [-DataCenter <String>]
    [-Role <NodeRole[]>]
    [-ManagementIpAddress <String>]
    [-Rack <String>]
    [-ProductKey <String>]
    [-Location <String>]
    [-SubscribedCores <UInt32>]
    [-SubscribedSockets <UInt32>]
    [-Affinity <Boolean>]
    [-ClusterConnectionString <String[]>]
    [-Scheduler <String[]>]
    [<CommonParameters>]

Node

Set-HpcNode
    -Node <HpcNode[]>
    [-Description <String>]
    [-Chassis <String>]
    [-DataCenter <String>]
    [-Role <NodeRole[]>]
    [-ManagementIpAddress <String>]
    [-Rack <String>]
    [-ProductKey <String>]
    [-Location <String>]
    [-SubscribedCores <UInt32>]
    [-SubscribedSockets <UInt32>]
    [-Affinity <Boolean>]
    [-ClusterConnectionString <String[]>]
    [-Scheduler <String[]>]
    [<CommonParameters>]

说明

Set-HpcNode cmdlet 更改一个或多个节点的属性，包括节点的说明、位置、角色和产品密钥。

示例

示例 1：设置节点的说明：设置节点的说明

PS C:\>Set-HpcNode -Name "hpc01cn01" -Description "Test Node"

此命令将名为 hpc01cn01 的节点的说明设置为测试节点。

示例 2：设置多个节点的位置：设置多个节点的位置

PS C:\>Set-HpcNode -Name "hpc01*" -DataCenter "East"

此命令将数据中心设置为 East，用于所有名称以 hpc01 开头的节点。

示例 3：设置节点的位置：设置节点的位置

PS C:\>Set-HpcNode -Name "ComputeNode02" -Location "\center4\rack3\chassis26"

此命令将名为 ComputeNode02 的节点位置设置为 \center4\rack3\chassis26。

示例 4：按组名称获取节点并设置其角色：按组名称获取节点并设置其角色

PS C:\>Get-HpcNode -GroupName "Broker" | Set-HpcNode -Role BrokerNode

此命令获取名为 Broker 的节点组中所有节点的 HpcNode 对象，并将这些节点的角色设置为 BrokerNode。

参数

-Affinity

指示如何管理节点上运行的任务的相关性。 默认情况下，该值$Null，这意味着根据作业计划程序关联策略管理相关性。 如果设置了此属性，节点相关性将替代作业计划程序相关性设置。 值为 0 或$False指定节点上的相关性不受 HPC 服务管理，作系统或应用程序管理物理核心上任务的位置。 值为 1 或$True指定 HPC Node Manager 服务为任务设置相关性（将任务分配给特定核心）。

有关相关性的详细信息，请参阅了解相关性http://technet.microsoft.com/library/ff919424(WS.10).aspx.

此参数是在 HPC Pack 2008 R2 和 Service Pack 2（SP2）中引入的。 以前版本不支持它。

参数属性

类型:	Boolean
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-Chassis

指定节点所在的机箱。 如果指定 机箱 参数，则还必须指定 DataCenter 和 Rack 参数。

自 Microsoft® HPC Pack 2012 起，此参数已弃用。 请改用 Location 参数。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-ClusterConnectionString

为要向其添加设备驱动程序的群集指定群集连接字符串数组。 值格式为 host1，host2，host3。 如果未指定 ClusterConnectionString 参数，则此 cmdlet 会在CCP_CONNECTIONSTRING环境变量指定的头节点上使用连接字符串。 若要设置此环境变量，请运行以下 cmdlet：Set-Content Env: CCP_CONNECTIONSTRING \<head_node_name\>。

此参数是在 HPC Pack 2016 中引入的。

参数属性

类型:	String[]
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-DataCenter

指定节点所在的数据中心。

自 Microsoft® HPC Pack 2012 起，此参数已弃用。 请改用 Location 参数。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-Description

指定节点的说明。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-Location

将节点的位置指定为字符串，格式为 \<DataCenter>[\Rack>[\<<Chassis>]]。

位置必须以反斜杠 （\） 开头。 如果指定字符串的 <Rack> 部分，则还必须指定 <DataCenter> 部件。 如果指定 <字符串的机箱> 部分，则还必须指定 <Rack> 和 <DataCenter> 部件。 字符串的每个部分的最大长度为 256 个字符。

如果指定位置字符串包含三个以上的部分，例如 \center1\rack3\chassis5\location7\sublocation9，则不会发生错误，并且该位置将在字符串的第三部分后截断。 因此，\center1\rack3\chassis5\location7\sublocation9 的值变为 \center1\rack3\chassis5。

此参数是在 HPC Pack 2008 R2 中引入的。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-ManagementIpAddress

指定智能平台管理接口（IPMI）工具可用于管理节点上电源的 IP 地址。 此参数的值的格式与有效 IP 地址的格式相同。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-Name

指定要更改其属性的节点的名称数组。 不能同时指定 Name 和 Node 参数。

参数属性

类型:	String[]
默认值:	None
支持通配符:	False
不显示:	False

参数集

Name

Position:	1
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-Node

指定要更改其属性的节点的 HpcNode 对象的数组。 使用 Get-HpcNode cmdlet 获取节点的 HpcNode 对象。 不能同时指定 Node 和 Name 参数。

参数属性

类型:	HpcNode[]
默认值:	None
支持通配符:	False
不显示:	False

参数集

Node

Position:	Named
必需:	True
来自管道的值:	True
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-ProductKey

指定预配节点时要使用的 Windows Server 2008 的产品密钥。 产品密钥的格式应为 xxxxx-xxxxx-xxxxx-xxxxx-xxxxx-xxxxx，其中 x 是大小写字母或数字。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-Rack

指定节点的机架位置。 如果指定 Rack 参数，则还必须指定 DataCenter 参数。

自 Microsoft® HPC Pack 2012 起，此参数已弃用。 请改用 Location 参数。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-Role

指定节点的角色数组。 有效值为：

• 没有
• ComputeNode
• BrokerNode
• WorkstationNode

在更改节点角色之前，请让节点脱机。 使用 Set-HpcNodeState cmdlet 使节点脱机。

参数属性

类型:	NodeRole[]
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-Scheduler

指定包含节点的群集的头节点的主机名或 IP 地址。 该值必须是有效的计算机名称或 IP 地址。 如果未指定 计划程序 参数，则此 cmdlet 会在CCP_SCHEDULER环境变量指定的头节点上使用计划程序。 若要设置此环境变量，请运行以下 cmdlet：

Set-Content Env:CCP_SCHEDULER \<head_node_name\>

参数属性

类型:	String[]
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-SubscribedCores

指定在将任务分配给节点时希望 HPC 作业计划程序服务使用的核心数。 此值可能小于或超过物理核心数。 若要清除此属性，请将值设置为$Null。 如果此值$Null，则使用物理核心数。

应确保已订阅核心数被订阅套接字数分割。 因此，每个套接字必须具有相同的内核数（例如 4 个核心和 2 个套接字有效，但 10 个核心和 4 个套接字无效）。

此参数是在 HPC Pack 2008 R2 和 Service Pack 2（SP2）中引入的。 以前版本不支持它。

参数属性

类型:	UInt32
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-SubscribedSockets

指定 HPC 作业计划程序服务在向节点分配任务时应使用的套接字数。 此值可能小于或超过实际物理套接字的数量。 若要清除此属性，请将值设置为$Null。

应确保已订阅核心数被订阅套接字数分割。 因此，每个套接字必须具有相同的内核数（例如 4 个核心和 2 个套接字有效，但 10 个核心和 4 个套接字不是）。

此参数是在 HPC Pack 2008 R2 和 Service Pack 2（SP2）中引入的。 以前版本不支持它。

参数属性

类型:	UInt32
默认值:	None
支持通配符:	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。

输入

HpcNode

输出

HpcNode

备注

• 自 HPC Pack 2012 起，此 DataCenter、 Rack 和 Chassis 参数已弃用。 请改用 Location 参数。
• 如果在运行 Set-HpcNode 时为节点指定 Location 参数，则不会设置节点的 HpcNode 对象的 DataCenter、Rack 和 Chassis 属性。 如果在运行 Set-HpcNode 时指定 DataCenter、Rack 或 Chassis 参数，则节点的 HpcNode 对象的 Location 属性将设置为等效的位置字符串。
• 必须是群集管理员才能成功运行此 cmdlet。

相关链接

• Get-HpcNode
• Remove-HpcNode
• Restart-HpcNode
• Shutdown-HpcNode
• Start-HpcNode