Windows PowerShell Cmdlet Equivalents for HPC Command-Line Commands

Article
06/06/2012

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).

Share via

Windows PowerShell Cmdlet Equivalents for HPC Command-Line Commands

See Also

Concepts

Other Resources

Additional resources