diff --git a/src/System.Management.Automation/engine/hostifaces/ConnectionFactory.cs b/src/System.Management.Automation/engine/hostifaces/ConnectionFactory.cs
index 014eed0f54..45591ee290 100644
--- a/src/System.Management.Automation/engine/hostifaces/ConnectionFactory.cs
+++ b/src/System.Management.Automation/engine/hostifaces/ConnectionFactory.cs
@@ -476,58 +476,64 @@ namespace System.Management.Automation.Runspaces
#region Runspace - Remote Factory
///
+ /// Creates a remote Runspace.
///
+ /// It defines connection path to a remote runspace that needs to be created.
+ /// The explicit PSHost implementation.
///
/// The TypeTable to use while deserializing/serializing remote objects.
/// TypeTable has the following information used by serializer:
/// 1. SerializationMethod
/// 2. SerializationDepth
/// 3. SpecificSerializationProperties
+ ///
/// TypeTable has the following information used by deserializer:
/// 1. TargetTypeForDeserialization
/// 2. TypeConverter
///
- ///
- ///
- ///
+ /// A remote Runspace.
public static Runspace CreateRunspace(RunspaceConnectionInfo connectionInfo, PSHost host, TypeTable typeTable)
{
return CreateRunspace(connectionInfo, host, typeTable, null, null);
}
///
+ /// Creates a remote Runspace.
///
+ /// It defines connection path to a remote runspace that needs to be created.
+ /// The explicit PSHost implementation.
///
/// The TypeTable to use while deserializing/serializing remote objects.
/// TypeTable has the following information used by serializer:
/// 1. SerializationMethod
/// 2. SerializationDepth
/// 3. SpecificSerializationProperties
+ ///
/// TypeTable has the following information used by deserializer:
/// 1. TargetTypeForDeserialization
/// 2. TypeConverter
///
- ///
- ///
///
/// Application arguments the server can see in
///
- ///
+ /// A remote Runspace.
public static Runspace CreateRunspace(RunspaceConnectionInfo connectionInfo, PSHost host, TypeTable typeTable, PSPrimitiveDictionary applicationArguments)
{
return CreateRunspace(connectionInfo, host, typeTable, applicationArguments, null);
}
///
+ /// Creates a remote Runspace.
///
- ///
- ///
+ /// It defines connection path to a remote runspace that needs to be created.
+ /// The explicit PSHost implementation.
///
/// The TypeTable to use while deserializing/serializing remote objects.
/// TypeTable has the following information used by serializer:
/// 1. SerializationMethod
/// 2. SerializationDepth
/// 3. SpecificSerializationProperties
+ ///
/// TypeTable has the following information used by deserializer:
/// 1. TargetTypeForDeserialization
/// 2. TypeConverter
@@ -536,7 +542,7 @@ namespace System.Management.Automation.Runspaces
/// Application arguments the server can see in
///
/// Name for remote runspace.
- ///
+ /// A remote Runspace.
public static Runspace CreateRunspace(RunspaceConnectionInfo connectionInfo, PSHost host, TypeTable typeTable, PSPrimitiveDictionary applicationArguments, string name)
{
if (connectionInfo is WSManConnectionInfo)
@@ -548,19 +554,21 @@ namespace System.Management.Automation.Runspaces
}
///
+ /// Creates a remote Runspace.
///
- ///
- ///
- ///
+ /// The explicit PSHost implementation.
+ /// It defines connection path to a remote runspace that needs to be created.
+ /// A remote Runspace.
public static Runspace CreateRunspace(PSHost host, RunspaceConnectionInfo connectionInfo)
{
return CreateRunspace(connectionInfo, host, null);
}
///
+ /// Creates a remote Runspace.
///
- ///
- ///
+ /// It defines connection path to a remote runspace that needs to be created.
+ /// A remote Runspace.
public static Runspace CreateRunspace(RunspaceConnectionInfo connectionInfo)
{
return CreateRunspace(null, connectionInfo);
@@ -571,9 +579,20 @@ namespace System.Management.Automation.Runspaces
#region V3 Extensions
///
+ /// Creates an out-of-process remote Runspace.
///
- ///
- ///
+ ///
+ /// The TypeTable to use while deserializing/serializing remote objects.
+ /// TypeTable has the following information used by serializer:
+ /// 1. SerializationMethod
+ /// 2. SerializationDepth
+ /// 3. SpecificSerializationProperties
+ ///
+ /// TypeTable has the following information used by deserializer:
+ /// 1. TargetTypeForDeserialization
+ /// 2. TypeConverter
+ ///
+ /// An out-of-process remote Runspace.
public static Runspace CreateOutOfProcessRunspace(TypeTable typeTable)
{
NewProcessConnectionInfo connectionInfo = new NewProcessConnectionInfo(null);
@@ -582,10 +601,21 @@ namespace System.Management.Automation.Runspaces
}
///
+ /// Creates an out-of-process remote Runspace.
///
- ///
- ///
- ///
+ ///
+ /// The TypeTable to use while deserializing/serializing remote objects.
+ /// TypeTable has the following information used by serializer:
+ /// 1. SerializationMethod
+ /// 2. SerializationDepth
+ /// 3. SpecificSerializationProperties
+ ///
+ /// TypeTable has the following information used by deserializer:
+ /// 1. TargetTypeForDeserialization
+ /// 2. TypeConverter
+ ///
+ /// It represents a PowerShell process that is used for an out-of-process remote Runspace
+ /// An out-of-process remote Runspace.
public static Runspace CreateOutOfProcessRunspace(TypeTable typeTable, PowerShellProcessInstance processInstance)
{
NewProcessConnectionInfo connectionInfo = new NewProcessConnectionInfo(null) { Process = processInstance };
diff --git a/src/System.Management.Automation/engine/hostifaces/PowerShellProcessInstance.cs b/src/System.Management.Automation/engine/hostifaces/PowerShellProcessInstance.cs
index 3f4dcf4074..076aee75ae 100644
--- a/src/System.Management.Automation/engine/hostifaces/PowerShellProcessInstance.cs
+++ b/src/System.Management.Automation/engine/hostifaces/PowerShellProcessInstance.cs
@@ -11,6 +11,7 @@ using System.Text;
namespace System.Management.Automation.Runspaces
{
///
+ /// This class represents a PowerShell process that is used for an out-of-process remote Runspace.
///
public sealed class PowerShellProcessInstance : IDisposable
{
@@ -30,8 +31,6 @@ namespace System.Management.Automation.Runspaces
#region Constructors
- ///
- ///
static PowerShellProcessInstance()
{
#if UNIX
@@ -145,10 +144,10 @@ namespace System.Management.Automation.Runspaces
///
/// Initializes a new instance of the class. Initializes the underlying dotnet process class.
///
- ///
- ///
- ///
- ///
+ /// Specifies the version of powershell.
+ /// Specifies a user account credentials.
+ /// Specifies a script that will be executed when the powershell process is initialized.
+ /// Specifies if the powershell process will be 32-bit.
public PowerShellProcessInstance(Version powerShellVersion, PSCredential credential, ScriptBlock initializationScript, bool useWow64) : this(powerShellVersion, credential, initializationScript, useWow64, workingDirectory: null)
{
}
@@ -178,7 +177,9 @@ namespace System.Management.Automation.Runspaces
#endregion Constructors
#region Dispose
+
///
+ /// Implementing the interface.
///
public void Dispose()
{
@@ -186,9 +187,6 @@ namespace System.Management.Automation.Runspaces
GC.SuppressFinalize(this);
}
- ///
- ///
- ///
private void Dispose(bool disposing)
{
if (_isDisposed) return;
@@ -220,7 +218,9 @@ namespace System.Management.Automation.Runspaces
#endregion Dispose
#region Public Properties
+
///
+ /// Gets the process object of the remote target.
///
public Process Process { get; }