IRemoteCommand interface

Defines a command to execute on one or more nodes in the cluster.

To get this interface, call the IScheduler::CreateCommand method.

Members

The IRemoteCommand interface inherits from the IDispatch interface. IRemoteCommand also has these types of members:

  • Methods
  • Properties

Methods

The IRemoteCommand interface has these methods.

Method Description
Cancel

Cancels the command.

Start

Executes the command.

StartWithCredentials

Executes the command using the specified credentials.

 

Properties

The IRemoteCommand interface has these properties.

Property Access type Description

CommandLine

Read-only

Retrieves the command line to execute.

Id

Read-only

Retrieves the identifier that uniquely identifies the command in the cluster.

NodeNames

Read-only

Retrieves the collection of node names on which the command will run or has run.

ProxyTaskId

Read-only

Retrieves the unique task identifier for the proxy task in a remote command job. The proxy task is the task that sends the output and error streams from all of the nodes in a remote command to the client.

 

Remarks

Only cluster administrators can run commands.

Commands are special jobs that run immediately on the specified nodes. You cannot rerun a command.

If you want to receive event notification when the state of the command changes, implement the IRemoteCommandEvents interface. For details, see Implementing the Event Handlers for Command Events in C++.

Requirements

Product

HPC Pack 2008 R2 Client Utilities, HPC Pack 2008 Client Utilities

Type library

Microsoft.Hpc.Scheduler.tlb

See also

HPC Interfaces

IRemoteCommandEvents