StartJobCommand StartJobCommand StartJobCommand StartJobCommand Class

Definition

This cmdlet start invocation of jobs in background.

public ref class StartJobCommand : Microsoft::PowerShell::Commands::PSExecutionCmdlet, IDisposable
[System.Management.Automation.Cmdlet("Start", "Job", DefaultParameterSetName="ComputerName", HelpUri="https://go.microsoft.com/fwlink/?LinkID=113405")]
public class StartJobCommand : Microsoft.PowerShell.Commands.PSExecutionCmdlet, IDisposable
type StartJobCommand = class
    inherit PSExecutionCmdlet
    interface IDisposable
Public Class StartJobCommand
Inherits PSExecutionCmdlet
Implements IDisposable
Inheritance
Attributes
Implements

Constructors

StartJobCommand() StartJobCommand() StartJobCommand() StartJobCommand()

Properties

AllowRedirection AllowRedirection AllowRedirection AllowRedirection

Overriding to suppress this parameter

ApplicationName ApplicationName ApplicationName ApplicationName

Overriding to suppress this parameter

ArgumentList ArgumentList ArgumentList ArgumentList

ArgumentList.

Authentication Authentication Authentication Authentication

Use basic authentication to authenticate the user.

CertificateThumbprint CertificateThumbprint CertificateThumbprint CertificateThumbprint

Overriding to suppress this parameter

CommandOrigin CommandOrigin CommandOrigin CommandOrigin

This property tells you if you were being invoked inside the runspace or if it was an external request.

(Inherited from InternalCommand)
CommandRuntime CommandRuntime CommandRuntime CommandRuntime

Holds the command runtime object for this command. This object controls what actually happens when a write is called.

(Inherited from Cmdlet)
ComputerName ComputerName ComputerName ComputerName

Overriding to suppress this parameter

ConfigurationName ConfigurationName ConfigurationName ConfigurationName

Overriding to suppress this parameter

ConnectionUri ConnectionUri ConnectionUri ConnectionUri

Overriding to suppress this parameter

ContainerId ContainerId ContainerId ContainerId

Overriding to suppress this parameter

Credential Credential Credential Credential

Credential to use for this job

CurrentPSTransaction CurrentPSTransaction CurrentPSTransaction CurrentPSTransaction

Gets an object that surfaces the current PowerShell transaction. When this object is disposed, PowerShell resets the active transaction

(Inherited from Cmdlet)
DefinitionName DefinitionName DefinitionName DefinitionName

JobDefintion Name.

DefinitionPath DefinitionPath DefinitionPath DefinitionPath

JobDefinition file path.

DisconnectedSessionName DisconnectedSessionName DisconnectedSessionName DisconnectedSessionName

Session names optionally provided for Disconnected parameter.

(Inherited from PSExecutionCmdlet)
EnableNetworkAccess EnableNetworkAccess EnableNetworkAccess EnableNetworkAccess

Not used for OutOfProc jobs. Suppressing this parameter.

Events Events Events Events

Gets the event manager for the current runspace.

(Inherited from PSCmdlet)
FilePath FilePath FilePath FilePath

Filepath to execute as a script

Host Host Host Host

Gets the host interaction APIs.

(Inherited from PSCmdlet)
HostName HostName HostName HostName
InitializationScript InitializationScript InitializationScript InitializationScript

Script that is used to initialize the background job.

InputObject InputObject InputObject InputObject

InputObject.

InvokeAndDisconnect InvokeAndDisconnect InvokeAndDisconnect InvokeAndDisconnect

Indicates that if a job/command is invoked remotely the connection should be severed right have invocation of job/command.

(Inherited from PSExecutionCmdlet)
InvokeCommand InvokeCommand InvokeCommand InvokeCommand

Provides access to utility routines for executing scripts and creating script blocks.

(Inherited from PSCmdlet)
InvokeProvider InvokeProvider InvokeProvider InvokeProvider

Gets the instance of the provider interface APIs for the current runspace.

(Inherited from PSCmdlet)
IsLiteralPath IsLiteralPath IsLiteralPath IsLiteralPath

True if FilePath should be processed as a literal path

(Inherited from PSExecutionCmdlet)
JobManager JobManager JobManager JobManager

Manager for JobSourceAdapters registered.

(Inherited from PSCmdlet)
JobRepository JobRepository JobRepository JobRepository

Repostiory for jobs

(Inherited from PSCmdlet)
KeyFilePath KeyFilePath KeyFilePath KeyFilePath

Suppress KeyFilePath

LiteralPath LiteralPath LiteralPath LiteralPath

Literal Filepath to execute as a script

MyInvocation MyInvocation MyInvocation MyInvocation

Contains information about the identity of this cmdlet and how it was invoked.

(Inherited from PSCmdlet)
Name Name Name Name

Friendly name for this job object

PagingParameters PagingParameters PagingParameters PagingParameters

If the cmdlet declares paging support (via SupportsPaging), then PagingParameters property contains arguments of the paging parameters. Otherwise PagingParameters property is null.

(Inherited from PSCmdlet)
ParameterSetName ParameterSetName ParameterSetName ParameterSetName

The name of the parameter set in effect.

(Inherited from PSCmdlet)
Port Port Port Port

Overriding to suppress this parameter

PSVersion PSVersion PSVersion PSVersion

Powershell Version to execute the background job

ResolvedComputerNames ResolvedComputerNames ResolvedComputerNames ResolvedComputerNames

Computer names after they have been resolved (null, empty string, "." resolves to localhost)

(Inherited from PSRemotingBaseCmdlet)
RunAs32 RunAs32 RunAs32 RunAs32

Launces the background job as a 32-bit process. This can be used on 64-bit systems to launch a 32-bit wow process for the background job.

RunAsAdministrator RunAsAdministrator RunAsAdministrator RunAsAdministrator

Overriding to suppress this parameter

ScriptBlock ScriptBlock ScriptBlock ScriptBlock

Command to execute specified as a string. This can be a single cmdlet, an expression or anything that can be internally converted into a ScriptBlock

Session Session Session Session

Overriding to suppress this parameter

SessionOption SessionOption SessionOption SessionOption

Extended Session Options for controlling the session creation. Use "New-WSManSessionOption" cmdlet to supply value for this parameter.

SessionState SessionState SessionState SessionState

Gets the instance of session state for the current runspace.

(Inherited from PSCmdlet)
SSHConnection SSHConnection SSHConnection SSHConnection

Suppress SSHConnection

SSHTransport SSHTransport SSHTransport SSHTransport

Suppress SSHTransport

Stopping Stopping Stopping Stopping

Is this command stopping?

(Inherited from Cmdlet)
Subsystem Subsystem Subsystem Subsystem
ThrottleLimit ThrottleLimit ThrottleLimit ThrottleLimit

Overriding to suppress this parameter

Type Type Type Type

Job SourceAdapter type for this job definition.

UserName UserName UserName UserName

Suppress UserName

UseSSL UseSSL UseSSL UseSSL

Overriding to suppress this parameter

VMId VMId VMId VMId

Overriding to suppress this parameter

VMName VMName VMName VMName

Overriding to suppress this parameter

Methods

BeginProcessing() BeginProcessing() BeginProcessing() BeginProcessing()
  1. Set the throttling limit and reset operations complete
  2. Create helper objects
  3. For async case, write the async result object down the pipeline
CloseAllInputStreams() CloseAllInputStreams() CloseAllInputStreams() CloseAllInputStreams()

Closes the input streams on all the pipelines

(Inherited from PSExecutionCmdlet)
CreateHelpersForSpecifiedComputerNames() CreateHelpersForSpecifiedComputerNames() CreateHelpersForSpecifiedComputerNames() CreateHelpersForSpecifiedComputerNames()

Create a throttle operation using NewProcessConnectionInfo ie., Out-Of-Process runspace.

CreateHelpersForSpecifiedContainerSession() CreateHelpersForSpecifiedContainerSession() CreateHelpersForSpecifiedContainerSession() CreateHelpersForSpecifiedContainerSession()

Creates helper objects with the command for the specified container IDs or names.

(Inherited from PSExecutionCmdlet)
CreateHelpersForSpecifiedRunspaces() CreateHelpersForSpecifiedRunspaces() CreateHelpersForSpecifiedRunspaces() CreateHelpersForSpecifiedRunspaces()

Creates helper objects with the specified command for the specified remote runspaceinfo objects

(Inherited from PSExecutionCmdlet)
CreateHelpersForSpecifiedSSHComputerNames() CreateHelpersForSpecifiedSSHComputerNames() CreateHelpersForSpecifiedSSHComputerNames() CreateHelpersForSpecifiedSSHComputerNames()

Creates helper objects for SSH remoting computer names remoting.

(Inherited from PSExecutionCmdlet)
CreateHelpersForSpecifiedSSHHashComputerNames() CreateHelpersForSpecifiedSSHHashComputerNames() CreateHelpersForSpecifiedSSHHashComputerNames() CreateHelpersForSpecifiedSSHHashComputerNames()

Creates helper objects for SSH remoting from HashTable parameters.

(Inherited from PSExecutionCmdlet)
CreateHelpersForSpecifiedUris() CreateHelpersForSpecifiedUris() CreateHelpersForSpecifiedUris() CreateHelpersForSpecifiedUris()

Creates helper objects with the command for the specified remote connection uris

(Inherited from PSExecutionCmdlet)
CreateHelpersForSpecifiedVMSession() CreateHelpersForSpecifiedVMSession() CreateHelpersForSpecifiedVMSession() CreateHelpersForSpecifiedVMSession()

Creates helper objects with the command for the specified VM GUIDs or VM names.

(Inherited from PSExecutionCmdlet)
CurrentProviderLocation(String) CurrentProviderLocation(String) CurrentProviderLocation(String) CurrentProviderLocation(String) Inherited from PSCmdlet
Dispose() Dispose() Dispose() Dispose()

Dispose the cmdlet

EndProcessing() EndProcessing() EndProcessing() EndProcessing()

InvokeAsync would have been called in ProcessRecord. Wait here for all the results to become available.

GetResolvedProviderPathFromPSPath(String, ProviderInfo) GetResolvedProviderPathFromPSPath(String, ProviderInfo) GetResolvedProviderPathFromPSPath(String, ProviderInfo) GetResolvedProviderPathFromPSPath(String, ProviderInfo) Inherited from PSCmdlet
GetResourceString(String, String) GetResourceString(String, String) GetResourceString(String, String) GetResourceString(String, String)

Gets the resource string corresponding to baseName and resourceId from the current assembly. You should override this if you require a different behavior.

(Inherited from Cmdlet)
GetScriptBlockFromFile(String, Boolean) GetScriptBlockFromFile(String, Boolean) GetScriptBlockFromFile(String, Boolean) GetScriptBlockFromFile(String, Boolean)

Reads content of file and converts it to a scriptblock

(Inherited from PSExecutionCmdlet)
GetUnresolvedProviderPathFromPSPath(String) GetUnresolvedProviderPathFromPSPath(String) GetUnresolvedProviderPathFromPSPath(String) GetUnresolvedProviderPathFromPSPath(String) Inherited from PSCmdlet
GetVariableValue(String) GetVariableValue(String) GetVariableValue(String) GetVariableValue(String) Inherited from PSCmdlet
GetVariableValue(String, Object) GetVariableValue(String, Object) GetVariableValue(String, Object) GetVariableValue(String, Object) Inherited from PSCmdlet
Invoke() Invoke() Invoke() Invoke()

Invoke this cmdlet object returning a collection of results.

(Inherited from Cmdlet)
Invoke<T>() Invoke<T>() Invoke<T>() Invoke<T>()

Returns a strongly-typed enumerator for the results of this cmdlet.

(Inherited from Cmdlet)
ParseSshHostName(String, String, String, Int32) ParseSshHostName(String, String, String, Int32) ParseSshHostName(String, String, String, Int32) ParseSshHostName(String, String, String, Int32) Inherited from PSRemotingBaseCmdlet
ProcessRecord() ProcessRecord() ProcessRecord() ProcessRecord()

The expression will be executed in the remote computer if a remote runspace parameter or computer name is specified. If none other than command parameter is specified, then it just executes the command locally without creating a new remote runspace object.

ResolveAppName(String) ResolveAppName(String) ResolveAppName(String) ResolveAppName(String)

Determines the appname to be used based on the following order: 1. AppName parameter specified 2. DEFAULTREMOTEAPPNAME variable set 3. WSMan

(Inherited from PSRemotingCmdlet)
ResolveComputerName(String) ResolveComputerName(String) ResolveComputerName(String) ResolveComputerName(String)

Resolves a computer name. If its null or empty its assumed to be localhost

(Inherited from PSRemotingCmdlet)
ResolveComputerNames(String[], String[]) ResolveComputerNames(String[], String[]) ResolveComputerNames(String[], String[]) ResolveComputerNames(String[], String[])

Resolve all the machine names provided. Basically, if a machine name is '.' assume localhost

(Inherited from PSRemotingCmdlet)
ResolveShell(String) ResolveShell(String) ResolveShell(String) ResolveShell(String)

Determines the shellname to use based on the following order: 1. ShellName parameter specified 2. DEFAULTREMOTESHELLNAME variable set 3. PowerShell

(Inherited from PSRemotingCmdlet)
ShouldContinue(String, String) ShouldContinue(String, String) ShouldContinue(String, String) ShouldContinue(String, String)

Confirm an operation or grouping of operations with the user. This differs from ShouldProcess in that it is not affected by preference settings or command-line parameters, it always does the query. This variant only offers Yes/No, not YesToAll/NoToAll.

(Inherited from Cmdlet)
ShouldContinue(String, String, Boolean, Boolean) ShouldContinue(String, String, Boolean, Boolean) ShouldContinue(String, String, Boolean, Boolean) ShouldContinue(String, String, Boolean, Boolean)

Confirm an operation or grouping of operations with the user. This differs from ShouldProcess in that it is not affected by preference settings or command-line parameters, it always does the query. This variant offers Yes, No, YesToAll and NoToAll.

(Inherited from Cmdlet)
ShouldContinue(String, String, Boolean, Boolean, Boolean) ShouldContinue(String, String, Boolean, Boolean, Boolean) ShouldContinue(String, String, Boolean, Boolean, Boolean) ShouldContinue(String, String, Boolean, Boolean, Boolean)

Confirm an operation or grouping of operations with the user. This differs from ShouldProcess in that it is not affected by preference settings or command-line parameters, it always does the query. This variant offers Yes, No, YesToAll and NoToAll.

(Inherited from Cmdlet)
ShouldProcess(String) ShouldProcess(String) ShouldProcess(String) ShouldProcess(String)

Confirm the operation with the user. Cmdlets which make changes (e.g. delete files, stop services etc.) should call ShouldProcess to give the user the opportunity to confirm that the operation should actually be performed.

(Inherited from Cmdlet)
ShouldProcess(String, String) ShouldProcess(String, String) ShouldProcess(String, String) ShouldProcess(String, String)

Confirm the operation with the user. Cmdlets which make changes (e.g. delete files, stop services etc.) should call ShouldProcess to give the user the opportunity to confirm that the operation should actually be performed.

This variant allows the caller to specify text for both the target resource and the action.

(Inherited from Cmdlet)
ShouldProcess(String, String, String) ShouldProcess(String, String, String) ShouldProcess(String, String, String) ShouldProcess(String, String, String)

Confirm the operation with the user. Cmdlets which make changes (e.g. delete files, stop services etc.) should call ShouldProcess to give the user the opportunity to confirm that the operation should actually be performed.

This variant allows the caller to specify the complete text describing the operation, rather than just the name and action.

(Inherited from Cmdlet)
ShouldProcess(String, String, String, ShouldProcessReason) ShouldProcess(String, String, String, ShouldProcessReason) ShouldProcess(String, String, String, ShouldProcessReason) ShouldProcess(String, String, String, ShouldProcessReason)

Confirm the operation with the user. Cmdlets which make changes (e.g. delete files, stop services etc.) should call ShouldProcess to give the user the opportunity to confirm that the operation should actually be performed.

This variant allows the caller to specify the complete text describing the operation, rather than just the name and action.

(Inherited from Cmdlet)
StopProcessing() StopProcessing() StopProcessing() StopProcessing()

When overridden in the derived class, interrupts currently running code within the command. It should interrupt BeginProcessing, ProcessRecord, and EndProcessing. Default implementation in the base class just returns.

(Inherited from Cmdlet)
ThrowTerminatingError(ErrorRecord) ThrowTerminatingError(ErrorRecord) ThrowTerminatingError(ErrorRecord) ThrowTerminatingError(ErrorRecord)

Terminate the command and report an error

(Inherited from Cmdlet)
TransactionAvailable() TransactionAvailable() TransactionAvailable() TransactionAvailable()

Returns true if a transaction is available and active.

(Inherited from Cmdlet)
ValidateComputerName(String[]) ValidateComputerName(String[]) ValidateComputerName(String[]) ValidateComputerName(String[])

Validates computer names to check if none of them happen to be a Uri. If so this throws an error

(Inherited from PSRemotingBaseCmdlet)
ValidateRemoteRunspacesSpecified() ValidateRemoteRunspacesSpecified() ValidateRemoteRunspacesSpecified() ValidateRemoteRunspacesSpecified()

Validate the PSSession objects specified and write appropriate error records.

(Inherited from PSRemotingBaseCmdlet)
WriteCommandDetail(String) WriteCommandDetail(String) WriteCommandDetail(String) WriteCommandDetail(String)

Write text into pipeline execution log.

(Inherited from Cmdlet)
WriteDebug(String) WriteDebug(String) WriteDebug(String) WriteDebug(String)

Display debug information

(Inherited from Cmdlet)
WriteError(ErrorRecord) WriteError(ErrorRecord) WriteError(ErrorRecord) WriteError(ErrorRecord)

Internal variant: Writes the specified error to the error pipe.

(Inherited from Cmdlet)
WriteInformation(InformationRecord) WriteInformation(InformationRecord) WriteInformation(InformationRecord) WriteInformation(InformationRecord)

Route information to the user or host.

(Inherited from Cmdlet)
WriteInformation(Object, String[]) WriteInformation(Object, String[]) WriteInformation(Object, String[]) WriteInformation(Object, String[])

Route information to the user or host.

(Inherited from Cmdlet)
WriteObject(Object) WriteObject(Object) WriteObject(Object) WriteObject(Object)

Writes the object to the output pipe.

(Inherited from Cmdlet)
WriteObject(Object, Boolean) WriteObject(Object, Boolean) WriteObject(Object, Boolean) WriteObject(Object, Boolean)

Writes one or more objects to the output pipe. If the object is a collection and the enumerateCollection flag is true, the objects in the collection will be written individually.

(Inherited from Cmdlet)
WriteProgress(ProgressRecord) WriteProgress(ProgressRecord) WriteProgress(ProgressRecord) WriteProgress(ProgressRecord)

Display progress information

(Inherited from Cmdlet)
WriteVerbose(String) WriteVerbose(String) WriteVerbose(String) WriteVerbose(String)

Display verbose information

(Inherited from Cmdlet)
WriteWarning(String) WriteWarning(String) WriteWarning(String) WriteWarning(String)

Display warning information

(Inherited from Cmdlet)

Fields

ComputerInstanceIdParameterSet ComputerInstanceIdParameterSet ComputerInstanceIdParameterSet ComputerInstanceIdParameterSet

Computername with session instance ID parameter set

(Inherited from PSRemotingCmdlet)
ComputerNameParameterSet ComputerNameParameterSet ComputerNameParameterSet ComputerNameParameterSet

Computername parameter set

(Inherited from PSRemotingCmdlet)
ContainerIdParameterSet ContainerIdParameterSet ContainerIdParameterSet ContainerIdParameterSet

Container ID parameter set

(Inherited from PSRemotingCmdlet)
DefaultPowerShellRemoteShellAppName DefaultPowerShellRemoteShellAppName DefaultPowerShellRemoteShellAppName DefaultPowerShellRemoteShellAppName

default application name for the connection uri

(Inherited from PSRemotingCmdlet)
DefaultPowerShellRemoteShellName DefaultPowerShellRemoteShellName DefaultPowerShellRemoteShellName DefaultPowerShellRemoteShellName

Default shellname

(Inherited from PSRemotingCmdlet)
FilePathComputerNameParameterSet FilePathComputerNameParameterSet FilePathComputerNameParameterSet FilePathComputerNameParameterSet

FilePathComputername parameter set

(Inherited from PSExecutionCmdlet)
FilePathContainerIdParameterSet FilePathContainerIdParameterSet FilePathContainerIdParameterSet FilePathContainerIdParameterSet

Container ID file path parameter set.

(Inherited from PSExecutionCmdlet)
FilePathSessionParameterSet FilePathSessionParameterSet FilePathSessionParameterSet FilePathSessionParameterSet

FilePathRunspace parameter set

(Inherited from PSExecutionCmdlet)
FilePathSSHHostHashParameterSet FilePathSSHHostHashParameterSet FilePathSSHHostHashParameterSet FilePathSSHHostHashParameterSet

SSH Host file path parameter set with HashTable connection parameter

(Inherited from PSExecutionCmdlet)
FilePathSSHHostParameterSet FilePathSSHHostParameterSet FilePathSSHHostParameterSet FilePathSSHHostParameterSet

SSH Host file path parameter set.

(Inherited from PSExecutionCmdlet)
FilePathUriParameterSet FilePathUriParameterSet FilePathUriParameterSet FilePathUriParameterSet

FilePathUri parameter set

(Inherited from PSExecutionCmdlet)
FilePathVMIdParameterSet FilePathVMIdParameterSet FilePathVMIdParameterSet FilePathVMIdParameterSet

VM guid file path parameter set.

(Inherited from PSExecutionCmdlet)
FilePathVMNameParameterSet FilePathVMNameParameterSet FilePathVMNameParameterSet FilePathVMNameParameterSet

VM name file path parameter set.

(Inherited from PSExecutionCmdlet)
LiteralFilePathComputerNameParameterSet LiteralFilePathComputerNameParameterSet LiteralFilePathComputerNameParameterSet LiteralFilePathComputerNameParameterSet

LiteralFilePathComputername parameter set

(Inherited from PSExecutionCmdlet)
SessionParameterSet SessionParameterSet SessionParameterSet SessionParameterSet

runspace parameter set

(Inherited from PSRemotingCmdlet)
SSHHostHashParameterSet SSHHostHashParameterSet SSHHostHashParameterSet SSHHostHashParameterSet

SSH host parmeter set supporting hash connection parameters

(Inherited from PSRemotingCmdlet)
SSHHostParameterSet SSHHostParameterSet SSHHostParameterSet SSHHostParameterSet

SSH host parameter set

(Inherited from PSRemotingCmdlet)
UriParameterSet UriParameterSet UriParameterSet UriParameterSet

Uri parameter set

(Inherited from PSRemotingBaseCmdlet)
VMIdParameterSet VMIdParameterSet VMIdParameterSet VMIdParameterSet

VM guid parameter set

(Inherited from PSRemotingCmdlet)
VMNameParameterSet VMNameParameterSet VMNameParameterSet VMNameParameterSet

VM name parameter set

(Inherited from PSRemotingCmdlet)

Applies to