RunspaceFactory.CreateRunspacePool Method

Reference

Definition

Namespace:: System.Management.Automation.Runspaces

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

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Overloads

CreateRunspacePool(Int32, Int32, RunspaceConnectionInfo, PSHost, TypeTable)	Creates a RunspacePool on the specified remote runspace computer. `maxRunspaces` limits the number of Runspaces that can exist in this pool. The minimum pool size is set to `minPoolSoze`.
CreateRunspacePool()	Creates a RunspacePool with MaxRunspaces 1 and MinRunspaces 1.
CreateRunspacePool(InitialSessionState)	Creates a RunspacePool using the supplied `initialSessionState`. The minimum runspaces size is set to 1. The maximum runspaces size is set to 1.
CreateRunspacePool(Int32, Int32)	Creates a RunspacePool `maxRunspaces` limits the number of Runspaces that can exist in this pool. The minimum pool size is set to `minPoolSoze`.
CreateRunspacePool(Int32, Int32, PSHost)	Creates a RunspacePool using the supplied `host`, `minRunspaces` and `maxRunspaces`
CreateRunspacePool(Int32, Int32, RunspaceConnectionInfo)	Creates a RunspacePool on the specified remote computer. `maxRunspaces` limits the number of Runspaces that can exist in this pool. The minimum pool size is set to `minPoolSoze`.
CreateRunspacePool(Int32, Int32, InitialSessionState, PSHost)	Creates a RunspacePool using the supplied `initialSessionState`, `minRunspaces` and `maxRunspaces`
CreateRunspacePool(Int32, Int32, RunspaceConnectionInfo, PSHost)	Creates a RunspacePool on the specified remote runspace computer. `maxRunspaces` limits the number of Runspaces that can exist in this pool. The minimum pool size is set to `minPoolSoze`.
CreateRunspacePool(Int32, Int32, RunspaceConnectionInfo, PSHost, TypeTable, PSPrimitiveDictionary)	Creates a RunspacePool on the specified remote runspace computer. `maxRunspaces` limits the number of Runspaces that can exist in this pool. The minimum pool size is set to `minPoolSoze`.

CreateRunspacePool(Int32, Int32, RunspaceConnectionInfo, PSHost, TypeTable)

Creates a RunspacePool on the specified remote runspace computer. maxRunspaces limits the number of Runspaces that can exist in this pool. The minimum pool size is set to minPoolSoze.

public:
 static System::Management::Automation::Runspaces::RunspacePool ^ CreateRunspacePool(int minRunspaces, int maxRunspaces, System::Management::Automation::Runspaces::RunspaceConnectionInfo ^ connectionInfo, System::Management::Automation::Host::PSHost ^ host, System::Management::Automation::Runspaces::TypeTable ^ typeTable);

public static System.Management.Automation.Runspaces.RunspacePool CreateRunspacePool (int minRunspaces, int maxRunspaces, System.Management.Automation.Runspaces.RunspaceConnectionInfo connectionInfo, System.Management.Automation.Host.PSHost host, System.Management.Automation.Runspaces.TypeTable typeTable);

static member CreateRunspacePool : int * int * System.Management.Automation.Runspaces.RunspaceConnectionInfo * System.Management.Automation.Host.PSHost * System.Management.Automation.Runspaces.TypeTable -> System.Management.Automation.Runspaces.RunspacePool

Public Shared Function CreateRunspacePool (minRunspaces As Integer, maxRunspaces As Integer, connectionInfo As RunspaceConnectionInfo, host As PSHost, typeTable As TypeTable) As RunspacePool

Parameters

minRunspaces: Int32

The minimum number of Runspace that should exist in this pool. Should be greater than 1.

maxRunspaces: Int32

The maximum number of Runspaces that can exist in this pool. Should be greater than or equal to 1.

connectionInfo: RunspaceConnectionInfo

RunspaceConnectionInfo object describing the remote computer on which this runspace pool needs to be created

host: PSHost

Host associated with this runspace pool

typeTable: TypeTable

The TypeTable to use while deserializing/serializing remote objects. TypeTable has the following information used by serializer:

SerializationMethod
SerializationDepth
SpecificSerializationProperties TypeTable has the following information used by deserializer:
TargetTypeForDeserialization
TypeConverter

If typeTable is null no custom serialization/deserialization can be done. Default PowerShell behavior will be used in this case.

Returns

RunspacePool

Exceptions

ArgumentException

Maximum Pool size is less than 1. Minimum Pool size is less than 1.

ArgumentNullException

connectionInfo is null

Applies to

CreateRunspacePool()

Creates a RunspacePool with MaxRunspaces 1 and MinRunspaces 1.

public:
 static System::Management::Automation::Runspaces::RunspacePool ^ CreateRunspacePool();

public static System.Management.Automation.Runspaces.RunspacePool CreateRunspacePool ();

static member CreateRunspacePool : unit -> System.Management.Automation.Runspaces.RunspacePool

Public Shared Function CreateRunspacePool () As RunspacePool

Returns

RunspacePool

Applies to

CreateRunspacePool(InitialSessionState)

Creates a RunspacePool using the supplied initialSessionState. The minimum runspaces size is set to 1. The maximum runspaces size is set to 1.

public:
 static System::Management::Automation::Runspaces::RunspacePool ^ CreateRunspacePool(System::Management::Automation::Runspaces::InitialSessionState ^ initialSessionState);

public static System.Management.Automation.Runspaces.RunspacePool CreateRunspacePool (System.Management.Automation.Runspaces.InitialSessionState initialSessionState);

static member CreateRunspacePool : System.Management.Automation.Runspaces.InitialSessionState -> System.Management.Automation.Runspaces.RunspacePool

Public Shared Function CreateRunspacePool (initialSessionState As InitialSessionState) As RunspacePool

Parameters

initialSessionState: InitialSessionState

initialSessionState to use when creating a new Runspace in the pool.

Returns

RunspacePool

Exceptions

ArgumentNullException

InitialSessionState is null.

Applies to

CreateRunspacePool(Int32, Int32)

Creates a RunspacePool maxRunspaces limits the number of Runspaces that can exist in this pool. The minimum pool size is set to minPoolSoze.

public:
 static System::Management::Automation::Runspaces::RunspacePool ^ CreateRunspacePool(int minRunspaces, int maxRunspaces);

public static System.Management.Automation.Runspaces.RunspacePool CreateRunspacePool (int minRunspaces, int maxRunspaces);

static member CreateRunspacePool : int * int -> System.Management.Automation.Runspaces.RunspacePool

Public Shared Function CreateRunspacePool (minRunspaces As Integer, maxRunspaces As Integer) As RunspacePool

Parameters

minRunspaces: Int32

The minimum number of Runspaces that exist in this pool. Should be greater than or equal to 1.

maxRunspaces: Int32

The maximum number of Runspaces that can exist in this pool. Should be greater than or equal to 1.

Returns

RunspacePool

Exceptions

ArgumentException

Maximum runspaces is less than 1. Minimum runspaces is less than 1.

Applies to

CreateRunspacePool(Int32, Int32, PSHost)

Creates a RunspacePool using the supplied host, minRunspaces and maxRunspaces

public:
 static System::Management::Automation::Runspaces::RunspacePool ^ CreateRunspacePool(int minRunspaces, int maxRunspaces, System::Management::Automation::Host::PSHost ^ host);

public static System.Management.Automation.Runspaces.RunspacePool CreateRunspacePool (int minRunspaces, int maxRunspaces, System.Management.Automation.Host.PSHost host);

static member CreateRunspacePool : int * int * System.Management.Automation.Host.PSHost -> System.Management.Automation.Runspaces.RunspacePool

Public Shared Function CreateRunspacePool (minRunspaces As Integer, maxRunspaces As Integer, host As PSHost) As RunspacePool

Parameters

minRunspaces: Int32

The minimum number of Runspaces that can exist in this pool. Should be greater than or equal to 1.

maxRunspaces: Int32

The maximum number of Runspaces that can exist in this pool. Should be greater than or equal to 1.

host: PSHost

The explicit PSHost implementation.

Returns

RunspacePool

A local runspacepool instance.

Exceptions

ArgumentNullException

host is null.

Applies to

CreateRunspacePool(Int32, Int32, RunspaceConnectionInfo)

Creates a RunspacePool on the specified remote computer. maxRunspaces limits the number of Runspaces that can exist in this pool. The minimum pool size is set to minPoolSoze.

public:
 static System::Management::Automation::Runspaces::RunspacePool ^ CreateRunspacePool(int minRunspaces, int maxRunspaces, System::Management::Automation::Runspaces::RunspaceConnectionInfo ^ connectionInfo);

public static System.Management.Automation.Runspaces.RunspacePool CreateRunspacePool (int minRunspaces, int maxRunspaces, System.Management.Automation.Runspaces.RunspaceConnectionInfo connectionInfo);

static member CreateRunspacePool : int * int * System.Management.Automation.Runspaces.RunspaceConnectionInfo -> System.Management.Automation.Runspaces.RunspacePool

Public Shared Function CreateRunspacePool (minRunspaces As Integer, maxRunspaces As Integer, connectionInfo As RunspaceConnectionInfo) As RunspacePool

Parameters

minRunspaces: Int32

The minimum number of Runspace that should exist in this pool. Should be greater than 1.

maxRunspaces: Int32

The maximum number of Runspaces that can exist in this pool. Should be greater than or equal to 1.

connectionInfo: RunspaceConnectionInfo

RunspaceConnectionInfo object describing the remote computer on which this runspace pool needs to be created

Returns

RunspacePool

Exceptions

ArgumentException

Maximum Pool size is less than 1. Minimum Pool size is less than 1.

ArgumentNullException

connectionInfo is null

Applies to

CreateRunspacePool(Int32, Int32, InitialSessionState, PSHost)

Creates a RunspacePool using the supplied initialSessionState, minRunspaces and maxRunspaces

public:
 static System::Management::Automation::Runspaces::RunspacePool ^ CreateRunspacePool(int minRunspaces, int maxRunspaces, System::Management::Automation::Runspaces::InitialSessionState ^ initialSessionState, System::Management::Automation::Host::PSHost ^ host);

public static System.Management.Automation.Runspaces.RunspacePool CreateRunspacePool (int minRunspaces, int maxRunspaces, System.Management.Automation.Runspaces.InitialSessionState initialSessionState, System.Management.Automation.Host.PSHost host);

static member CreateRunspacePool : int * int * System.Management.Automation.Runspaces.InitialSessionState * System.Management.Automation.Host.PSHost -> System.Management.Automation.Runspaces.RunspacePool

Public Shared Function CreateRunspacePool (minRunspaces As Integer, maxRunspaces As Integer, initialSessionState As InitialSessionState, host As PSHost) As RunspacePool

Parameters

minRunspaces: Int32

The minimum number of Runspaces that can exist in this pool. Should be greater than or equal to 1.

maxRunspaces: Int32

The maximum number of Runspaces that can exist in this pool. Should be greater than or equal to 1.

initialSessionState: InitialSessionState

initialSessionState to use when creating a new Runspace in the pool.

host: PSHost

The explicit PSHost implementation.

Returns

RunspacePool

Exceptions

ArgumentNullException

initialSessionState is null. host is null.

ArgumentException

Maximum runspaces is less than 1. Minimum runspaces is less than 1.

Applies to

CreateRunspacePool(Int32, Int32, RunspaceConnectionInfo, PSHost)

Creates a RunspacePool on the specified remote runspace computer. maxRunspaces limits the number of Runspaces that can exist in this pool. The minimum pool size is set to minPoolSoze.

public:
 static System::Management::Automation::Runspaces::RunspacePool ^ CreateRunspacePool(int minRunspaces, int maxRunspaces, System::Management::Automation::Runspaces::RunspaceConnectionInfo ^ connectionInfo, System::Management::Automation::Host::PSHost ^ host);

public static System.Management.Automation.Runspaces.RunspacePool CreateRunspacePool (int minRunspaces, int maxRunspaces, System.Management.Automation.Runspaces.RunspaceConnectionInfo connectionInfo, System.Management.Automation.Host.PSHost host);

static member CreateRunspacePool : int * int * System.Management.Automation.Runspaces.RunspaceConnectionInfo * System.Management.Automation.Host.PSHost -> System.Management.Automation.Runspaces.RunspacePool

Public Shared Function CreateRunspacePool (minRunspaces As Integer, maxRunspaces As Integer, connectionInfo As RunspaceConnectionInfo, host As PSHost) As RunspacePool

Parameters

minRunspaces: Int32

The minimum number of Runspace that should exist in this pool. Should be greater than 1.

maxRunspaces: Int32

The maximum number of Runspaces that can exist in this pool. Should be greater than or equal to 1.

connectionInfo: RunspaceConnectionInfo

RunspaceConnectionInfo object describing the remote computer on which this runspace pool needs to be created

host: PSHost

Host associated with this runspace pool

Returns

RunspacePool

Exceptions

ArgumentException

Maximum Pool size is less than 1. Minimum Pool size is less than 1.

ArgumentNullException

connectionInfo is null

Applies to

CreateRunspacePool(Int32, Int32, RunspaceConnectionInfo, PSHost, TypeTable, PSPrimitiveDictionary)

Creates a RunspacePool on the specified remote runspace computer. maxRunspaces limits the number of Runspaces that can exist in this pool. The minimum pool size is set to minPoolSoze.

public:
 static System::Management::Automation::Runspaces::RunspacePool ^ CreateRunspacePool(int minRunspaces, int maxRunspaces, System::Management::Automation::Runspaces::RunspaceConnectionInfo ^ connectionInfo, System::Management::Automation::Host::PSHost ^ host, System::Management::Automation::Runspaces::TypeTable ^ typeTable, System::Management::Automation::PSPrimitiveDictionary ^ applicationArguments);

public static System.Management.Automation.Runspaces.RunspacePool CreateRunspacePool (int minRunspaces, int maxRunspaces, System.Management.Automation.Runspaces.RunspaceConnectionInfo connectionInfo, System.Management.Automation.Host.PSHost host, System.Management.Automation.Runspaces.TypeTable typeTable, System.Management.Automation.PSPrimitiveDictionary applicationArguments);

static member CreateRunspacePool : int * int * System.Management.Automation.Runspaces.RunspaceConnectionInfo * System.Management.Automation.Host.PSHost * System.Management.Automation.Runspaces.TypeTable * System.Management.Automation.PSPrimitiveDictionary -> System.Management.Automation.Runspaces.RunspacePool

Public Shared Function CreateRunspacePool (minRunspaces As Integer, maxRunspaces As Integer, connectionInfo As RunspaceConnectionInfo, host As PSHost, typeTable As TypeTable, applicationArguments As PSPrimitiveDictionary) As RunspacePool

Parameters

minRunspaces: Int32

The minimum number of Runspace that should exist in this pool. Should be greater than 1.

maxRunspaces: Int32

The maximum number of Runspaces that can exist in this pool. Should be greater than or equal to 1.

connectionInfo: RunspaceConnectionInfo

RunspaceConnectionInfo object describing the remote computer on which this runspace pool needs to be created

host: PSHost

Host associated with this runspace pool

typeTable: TypeTable

The TypeTable to use while deserializing/serializing remote objects. TypeTable has the following information used by serializer:

SerializationMethod
SerializationDepth
SpecificSerializationProperties TypeTable has the following information used by deserializer:
TargetTypeForDeserialization
TypeConverter

If typeTable is null no custom serialization/deserialization can be done. Default PowerShell behavior will be used in this case.

applicationArguments: PSPrimitiveDictionary

Application arguments the server can see in ApplicationArguments

Returns

RunspacePool

Exceptions

ArgumentException

Maximum Pool size is less than 1. Minimum Pool size is less than 1.

ArgumentNullException

connectionInfo is null

Applies to

Share via

RunspaceFactory.CreateRunspacePool Method

Definition

Overloads

CreateRunspacePool(Int32, Int32, RunspaceConnectionInfo, PSHost, TypeTable)

Parameters

Returns

Exceptions

Applies to

CreateRunspacePool()

Returns

Applies to

CreateRunspacePool(InitialSessionState)

Parameters

Returns

Exceptions

Applies to

CreateRunspacePool(Int32, Int32)

Parameters

Returns

Exceptions

Applies to

CreateRunspacePool(Int32, Int32, PSHost)

Parameters

Returns

Exceptions

Applies to

CreateRunspacePool(Int32, Int32, RunspaceConnectionInfo)

Parameters

Returns

Exceptions

Applies to

CreateRunspacePool(Int32, Int32, InitialSessionState, PSHost)

Parameters

Returns

Exceptions

Applies to

CreateRunspacePool(Int32, Int32, RunspaceConnectionInfo, PSHost)

Parameters

Returns

Exceptions

Applies to

CreateRunspacePool(Int32, Int32, RunspaceConnectionInfo, PSHost, TypeTable, PSPrimitiveDictionary)

Parameters

Returns

Exceptions

Applies to

Additional resources