PowerShell Class

Gets or sets current powershell command line.

If an error occurred while executing the pipeline, this will be set to true.

The history string to be used for displaying the history.

Get unique id for this instance of runspace pool. It is primarily used for logging purposes.

Gets the execution state of the current PowerShell instance.

Gets the property which indicates if this PowerShell instance is nested.

Indicates if this PowerShell object is the owner of the runspace or RunspacePool assigned to this object.

Sets an associated Runspace for this PowerShell instance. This can be null in which case a new runspace is created whenever Invoke* method is called.

Sets an associated RunspacePool for this PowerShell instance. A Runspace from this pool is used whenever Invoke* method is called.

This can be null in which case a new runspace is created whenever Invoke* method is called.

Streams generated by PowerShell invocations.

Adds an argument to the last added command. For example, to construct a command string "get-process | select-object name"

PowerShell shell = PowerShell.Create("get-process").
                            AddCommand("select-object").AddParameter("name");

This will add the value "name" to the positional parameter list of "select-object" cmdlet. When the command is invoked, this value will get bound to positional parameter 0 of the "select-object" cmdlet which is "Property".

CommandInfo object for the command to add.

Add a cmdlet to construct a command pipeline. For example, to construct a command string "get-process | sort-object",

PowerShell shell = PowerShell.Create("get-process").AddCommand("sort-object");

Add a cmdlet to construct a command pipeline. For example, to construct a command string "get-process | sort-object",

PowerShell shell = PowerShell.Create("get-process").AddCommand("sort-object");

Add a parameter to the last added command. For example, to construct a command string "get-process | select-object -property name"

PowerShell shell = PowerShell.Create("get-process").
                            AddCommand("select-object").AddParameter("property","name");

Adds a switch parameter to the last added command. For example, to construct a command string "get-process | sort-object -descending"

PSCommand command = new PSCommand("get-process").
                            AddCommand("sort-object").AddParameter("descending");

Adds a set of parameters to the last added command.

Adds a set of parameters to the last added command.

Add a piece of script to construct a command pipeline. For example, to construct a command string "get-process | foreach { $_.Name }"

PowerShell shell = PowerShell.Create("get-process").
                            AddCommand("foreach { $_.Name }", true);

Add a piece of script to construct a command pipeline. For example, to construct a command string "get-process | foreach { $_.Name }"

PowerShell shell = PowerShell.Create("get-process").
                            AddCommand("foreach { $_.Name }", true);

Adds an additional statement for execution

For example,

Runspace rs = RunspaceFactory.CreateRunspace();
PowerShell ps = PowerShell.Create();

ps.Runspace = rs;
ps.AddCommand("Get-Process").AddArgument("idle");
ps.AddStatement().AddCommand("Get-Service").AddArgument("audiosrv");
ps.Invoke();

Returns a job object which can be used to control the invocation of the command with AsJob Parameter

Invoke the Command asynchronously. Use EndInvoke() to obtain the output of the command.

Invoke the Command asynchronously. Use EndInvoke() to obtain the output of the command.

Invoke the Command asynchronously. Use EndInvoke() to obtain the output of the command.

Invoke the Command asynchronously and collect output data into the buffer output. When this method is used EndInvoke() returns a null buffer.

Invoke the Command asynchronously. When this method is used EndInvoke() returns a null buffer.

Stop the currently running command asynchronously. If the command is not started, the state of PowerShell instance is changed to Stopped and corresponding events will be raised.

The returned IAsyncResult object can be used to wait for the stop operation to complete.

Synchronously connects to a running command on a remote server.

Asynchronously connects to a running command on a remote server. The returned IAsyncResult object can be used with EndInvoke() method to wait on command and/or get command returned data.

Asynchronously connects to a running command on a remote server. The returned IAsyncResult object can be used with EndInvoke() method to wait on command and/or get command returned data.

Constructs an empty PowerShell instance; a script or command must be added before invoking this instance.

Constructs an empty PowerShell instance; a script or command must be added before invoking this instance.

Constructs an empty PowerShell instance and associates it with the provided Runspace; a script or command must be added before invoking this instance.

Constructs an empty PowerShell instance; a script or command must be added before invoking this instance.

Creates a nested powershell within the current instance. Nested PowerShell is used to do simple operations like checking state of a variable while another command is using the runspace.

Nested PowerShell should be invoked from the same thread as the parent PowerShell invocation thread. So effectively the parent Powershell invocation thread is blocked until nested invoke() operation is complete.

Implement PSHost.EnterNestedPrompt to perform invoke() operation on the nested powershell.

Dispose all managed resources. This will suppress finalizer on the object from getting called by calling System.GC.SuppressFinalize(this).

Waits for the pending asynchronous BeginInvoke to complete.

Waits for the pending asynchronous BeginStop to complete.

Get a steppable pipeline object.

Invoke the Command synchronously and return the output PSObject collection.

Invoke the Command synchronously and return the output PSObject collection.

Invoke the Command synchronously and return the output PSObject collection.

Invoke the Command synchronously and return the output.

Invoke the Command synchronously and collect output data into the buffer output

Invoke the Command synchronously and collect output data into the buffer output

Invoke the Command synchronously and return the output.

Invoke the Command synchronously and return the output.

Invoke the Command synchronously and stream output data into the buffer output

Invoke a PowerShell command asynchronously. Use await to wait for the command to complete and obtain the output of the command.

Invoke a PowerShell command asynchronously. Use await to wait for the command to complete and obtain the output of the command.

Invoke a PowerShell command asynchronously. Use await to wait for the command to complete and obtain the output of the command.

Invoke a PowerShell command asynchronously and collect output data into the buffer output. Use await to wait for the command to complete and obtain the output of the command.

Invoke a PowerShell command asynchronously. Use await to wait for the command to complete and obtain the output of the command.

Stop the currently running command synchronously.

Stop a PowerShell command asynchronously. Use await to wait for the command to stop.

Event raised when PowerShell Execution State Changes.