次の方法で共有

Windows PowerShell Cmdlet Equivalents for HPC Command-Line Commands

  • [アーティクル]

Applies To: Windows HPC Server 2008, Windows HPC Server 2008 R2

Windows® HPC Server 2008 and Windows HPC Server 2008 R2 provide command-line commands and HPC cmdlets for Windows PowerShell as alternative ways to perform many of the same tasks that you can perform in HPC Cluster Manager. HPC cmdlets are HPC-specific cmdlets for Windows HPC PowerShell that become available when you add the Microsoft.HPC snap-in or open an HPC PowerShell window. You can use the command-line commands or HPC cmdlets in scripts to automate a series of tasks that you perform regularly.

You can use HPC cmdlets to perform most of the same tasks in Windows HPC Server 2008 and Windows HPC Server 2008 R2 that you can perform with command-line commands, in addition to many additional tasks that you cannot perform with command-line commands. Windows PowerShell also provides a powerful and flexible scripting environment, so you may want to consider converting existing command files and batch files that use command-line commands to PowerShell scripts to take advantage of these features.

The following table provides a list of the HPC cmdlets that are similar to the command-line commands in Windows HPC Server 2008 and Windows HPC Server 2008 R2. You can use them to convert command files and batch files that use command-line commands to PowerShell scripts. For command-line commands that have no equivalent HPC cmdlet, you can run the command-line commands within an HPC PowerShell window or in a script just as you would run them at a command prompt.

Note

The HPC cmdlet that the table lists is not always entirely identical to the corresponding command-line command. In some cases, the parameters that are available for the command-line command are not available or they differ from those for the HPC cmdlet, or the output for the HPC cmdlet differs slightly from that of the command-line command. In most cases, though, these differences are minor and you can use the PowerShell cmdlet for the same purposes as the command-line command. For more information about the parameters and the behavior of a specific HPC cmdlet, see the Help topic for that HPC cmdlet.

Command-line command Command-line example HPC cmdlet HPC cmdlet example

cluscfg delcreds

 
cluscfg delcreds /user:CONTOSO\someone

Remove-HpcJobCredential

 
Remove-HpcJobCredential -UserName CONTOSO\someone

cluscfg listenvs

 
cluscfg listenvs

Get-HpcClusterProperty with the Environment parameter

 
Get-HpcClusterProperty -Environment

cluscfg listparams

 
cluscfg listparams

Get-HpcClusterProperty with the Parameter parameter

 
Get-HpcClusterProperty -Parameter

cluscfg mailcred (Windows HPC Server 2008 R2 only)

 
cluscfg mailcred /user:CONTOSO\someone /password:*

Set-HpcClusterProperty with the EmailCredential parameter

 
Set-HpcClusterProperty -EmailCredential CONTOSO\someone

cluscfg setcreds

 
cluscfg setcreds /user:CONTOSO\someone

Set-HpcJobCredential

 
Set-HpcJobCredential -Credential CONTOSO\someone

cluscfg setenvs

 
cluscfg setenvs MyVariable=10

Set-HpcClusterProperty with the Environment parameter

 
Set-HpcClusterProperty -Environment MyVariable=10

cluscfg setparams

 
cluscfg setparams InactivityCount=5

Set-HpcClusterProperty with the parameter that has the same name as the cluster-wide parameter that you want to set, that is: Set-HpcClusterProperty -<ParameterName>.

 
Set-HpcClusterProperty -InactivityCount 5

cluscfg view

 
cluscfg view

Get-HpcClusterOverview

 
Get-HpcClusterOverview

clusrun

 
clusrun /all dir

None

 

etl2clog

 
mpiexec -cores 1 etl2clog mpi_trace.etl

None

 

etl2otf

 
mpiexec -cores 1 etl2otf mpi_trace.etl

None

 

hpcfwutil (Windows HPC Server 2008 R2 only)

 
hpcfwutil reset /v

None

 

job add

 
job add 184 /name:MyTask ipconfig

Add-HpcTask

 
Add-HpcTask -JobId 184 -Name MyTask -CommandLine ipconfig

job cancel

 
job cancel 215

Stop-HpcJob, with the job identifier for the running or pending job that you want to cancel specified by the Id parameter

 
Stop-HpcJob -Id 215

job finish (Windows HPC Server 2008 R2 only)

 
job finish 67

Stop-HpcJob with a value of Finished for the State parameter

 
Stop-HpcJob -Id 67 -State Finished

job list

 
job list /state:Configuring

Get-HpcJob

 
Get-HpcJob -State Configuring

job listtasks

 
job listtasks 79

Get-HpcTask, with the identifier of the job for which you want to list the tasks specified as the value of JobId parameter and then redirect the output to the Format-List (https://go.microsoft.com/fwlink/?LinkId=143534) cmdlet

 
Get-HpcTask -JobId 79 | Format-List

job modify

 
job modify 212 /runtime:0:0:30

Set-HpcJob

 
Set-HpcJob -Id 212 -Runtime 0:0:30

job new

 
job new /jobname:MyJob /projectname:MyProject -runtime:0:0:30

New-HpcJob

 
New-HpcJob -Name MyJob -Project MyProject -Runtime 0:0:30

job requeue

 
job requeue 214

Submit-HpcJob, with the job identifier for a job in the Canceled or Failed state that you want to requeue specified as the value for the Id parameter

 
Submit-HpcJob -Id 214

job submit

 
job submit /id:213

Submit-HpcJob

 
Submit-HpcJob -Id 213

job view

 
job view 177

Get-HpcJob, with the job identifier for the job for which you want to view information specified as the value for the Id parameter and then redirect the output to the Format-List (https://go.microsoft.com/fwlink/?LinkId=143534s) cmdlet

 
Get-HpcJob -Id 177 | Format-List

jobtemplate add

 
jobtemplate add /file:C:\MyTemplates\MyNewJobTemplate.xml

Import-HpcJobTemplate

 
Import-HpcJobTemplate -Path C:\MyTemplates\MyNewJobTemplate.xml -Name MyNewJobTemplate

jobtemplate delete

 
jobtemplate delete MyOutdatedJobTemplate

Remove-HpcJobTemplate

 
Remove-HpcJobTemplate -Name MyOutdatedJobTemplate

jobtemplate deny

 
jobtemplate deny MyJobTemplate CONTOSO\someone /perm:M

None

 

jobtemplate grant

 
jobtemplate grant MyJobTemplate CONTOSO\someone /perm:S

None

 

jobtemplate remove

 
jobtemplate remove MyJobTemplate CONTOSO\someone

None

 

jobtemplate list

 
jobtemplate list

Get-HpcJobTemplate

 
Get-HpcJobTemplate

jobtemplate view

 
jobtemplate view MyCustomJobTemplate

Get-HpcJobTemplate, with the name of the job template specified as the value for the Name parameter and then redirect the output to the Format-List (https://go.microsoft.com/fwlink/?LinkId=143534) cmdlet

 
Get-HpcJobTemplate -Name MyCustomJobTemplate | Format-List

mpicsync

 
mpiexec -cores 1 mpicsync mpi_trace.etl

None

 

mpiexec

 
mpiexec /np * app1

None

 

mpipingpong

 
job submit /numnodes:3 mpiexec /hosts 3 ComputeNode1 ComputeNode2 ComputeNode3 mpipingpong -pl

or

job submit /numnodes:3 mpiexec /hosts 3 ComputeNode1 ComputeNode2 ComputeNode3 mpipingpong -pt

For Windows HPC Server 2008, Invoke-HpcTest with one of the following values specified for the Name parameter: "MPI Ping-Pong: Quick Check" or "MPI Ping-Pong: Lightweight Throughput"

For Windows HPC Server 2008 R2, Invoke-HpcTest with one of the following values specified for the Alias parameter: mpipplatency or mpippthroughput

For Windows HPC Server 2008:

Invoke-HpcTest -Name "MPI Ping-Pong: Quick Check" -NodeName ComputeNode1,ComputeNode2,ComputeNode3

or

Invoke-HpcTest -Name "MPI Ping-Pong: Lightweight Throughput" -NodeName ComputeNode1,ComputeNode2,ComputeNode3

For Windows HPC Server 2008 R2:

Invoke-HpcTest -Alias mpipplatency -NodeName ComputeNode1,ComputeNode2,ComputeNode3

or

Invoke-HpcTest -Alias mpippthroughput -NodeName ComputeNode1,ComputeNode2,ComputeNode3

node list

 
node list

Get-HpcNode

 
Get-HpcNode

node listcores

 
node listcores

None

 

node offline (Windows HPC Server 2008 R2 only)

 
node offline computenode46

Set-HpcNodeState with a value of Offline specified for the State parameter

 
Set-HpcNodeState -Name computenode46 -State Offline

node online (Windows HPC Server 2008 R2 only)

 
node online computenode82

Set-HpcNodeState with a value of Online specified for the State parameter

 
Set-HpcNodeState -Name computenode82 -State Online

node view

 
node view MyComputeNode

Get-HpcNode, with the name of the node for which you want to view information specified as the value of the Name parameter and then redirect the output to the Format-List (https://go.microsoft.com/fwlink/?LinkId=143534) cmdlet

 
Get-HpcNode -Name MyComputeNode | Format-List

node pause (deprecated)

 
node pause MyComputeNode

Set-HpcNodeState with a value of Offline specified for the State parameter

 
Set-HpcNodeState -Name MyComputeNode -State Offline

node resume (deprecated)

 
node resume MyComputeNode

Set-HpcNodeState with a value of Online specified for the State parameter

 
Set-HpcNodeState -Name MyComputeNode -State Online

task cancel

 
task cancel 215.2

Get-HpcTask with the job and task identifiers specified by the JobId and TaskId parameters to get the HpcTask object for the task, then call the Cancel method for the HpcTask object

 
(Get-HpcTask -JobId 215 -TaskID 2).Cancel()

or

$t = Get-HpcTask -JobId 215 -TaskID 2
$t.Cancel()

task requeue

 
task requeue 215.3

Get-HpcTask with the job and task identifiers specified by the JobId and TaskId parameters to get the HpcTask object for the task, then call the Requeue method for the HpcTask object

 
(Get-HpcTask -JobId 215 -TaskID 3).Requeue()

or

$t = Get-HpcTask -JobId 215 -TaskID 3
$t.Requeue()

task view

 
task view 177.2

Get-HpcTask, with the job and task identifiers for the task specified by the JobId and TaskId parameters and the output redirected to the Format-List (https://go.microsoft.com/fwlink/?LinkId=143534) cmdlet

 
Get-HpcTask -JobId 177 -TaskId 2 | Format-List

test add (Windows HPC Server 2008 R2 only)

 
test add C:\DiagnosticTest\CustomSuite1.xml

Add-HpcTest

 
Add-HpcTest –File "C:\DiagnosticTest\CustomSuite1.xml"

test cancel (Windows HPC Server 2008 R2 only)

 
test cancel 28

Stop-HpcTestResult

 
Stop-HpcTestResult -RunId 28

test listruns (Windows HPC Server 2008 R2 only)

 
test listruns

Get-HpcTestResult

 
Get-HpcTestResult

test listtests (Windows HPC Server 2008 R2 only)

 
test listtests /server:HeadNode

Get-HpcTest

 
Get-HpcTest -Scheduler HeadNode

test remove (Windows HPC Server 2008 R2 only)

 
test remove MyCustomTest

Remove-HpcTest

 
Remove-HpcTest -Alias MyCustomTest

test run (Windows HPC Server 2008 R2 only)

 
test run MyDailyTest -nodes:HeadNode,ComputeNode1,ComputeNode2

Invoke-HpcTest

 
Invoke-HpcTest -Alias MyDailyTest -Nodes HeadNode,ComputeNode1,ComputeNode2

test setcreds (Windows HPC Server 2008 R2 only)

 
test setcreds /username:CONTOSO\someone

Set-HpcTestCredential

 
Set-HpcTestCrendential -Credential CONTOSO\someone

test viewresult (Windows HPC Server 2008 R2 only)

 
test viewresult 31

Run Export-HpcTestResult, then open the exported Report.html file

Run Export-HpcTestResult -RunId 31 -Path C:\TestResults\Run31, then open C:\TestResults\Run31\Report.html.

test viewrun (Windows HPC Server 2008 R2 only)

 
test viewrun 12

Get-HpcTestResultDetail

 
Get-HpcTestResultDetail –RunId 12

test viewtest (Windows HPC Server 2008 R2 only)

 
test viewtest CustomTest3

Get-HpcTestDetail

 
Get-HpcTestDetail –Alias CustomTest3

For information about using HPC PowerShell, see Appendix 6: Using HPC PowerShell (https://go.microsoft.com/fwlink/?LinkId=151474).

For information about using Windows PowerShell, see Windows PowerShell (https://go.microsoft.com/fwlink/?LinkId=128257) and Windows PowerShell (TechNet) (https://go.microsoft.com/fwlink/?LinkId=128426).

For information about built-in Windows PowerShell cmdlets, see Windows PowerShell Cmdlet Help Topics (https://go.microsoft.com/fwlink/?LinkId=113277).

See Also

Concepts

Windows HPC Server 2008 and Windows HPC Server 2008 R2 Command Reference Windows HPC Server 2008 PowerShell Reference

Other Resources

Windows HPC Server 2008 R2 PowerShell Reference