PowerShell.CreateNestedPowerShell Method

  • Reference

Definition

Namespace:
System.Management.Automation
Assembly:
System.Management.Automation.dll
Package:
Microsoft.PowerShell.5.1.ReferenceAssemblies v1.0.0
Package:
System.Management.Automation v7.0.13
Package:
System.Management.Automation v7.1.7
Package:
System.Management.Automation v7.2.12
Package:
System.Management.Automation v7.3.5
Package:
System.Management.Automation v7.4.0
Package:
Microsoft.WSMan.Runtime v6.1.0
Package:
Microsoft.WSMan.Runtime v6.2.0

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.

public:
 System::Management::Automation::PowerShell ^ CreateNestedPowerShell();
public System.Management.Automation.PowerShell CreateNestedPowerShell ();
member this.CreateNestedPowerShell : unit -> System.Management.Automation.PowerShell
Public Function CreateNestedPowerShell () As PowerShell

Returns

PowerShell

Exceptions

InvalidOperationException
  1. State of powershell instance is not valid to create a nested powershell instance. Nested PowerShell should be created only for a running powershell instance.

Applies to