diff --git a/src/System.Management.Automation/engine/hostifaces/PowerShell.cs b/src/System.Management.Automation/engine/hostifaces/PowerShell.cs
index 73bdbdb7c49..503d8e075b6 100644
--- a/src/System.Management.Automation/engine/hostifaces/PowerShell.cs
+++ b/src/System.Management.Automation/engine/hostifaces/PowerShell.cs
@@ -946,9 +946,11 @@ private static PowerShell Create(bool isNested, PSCommand psCommand, Collection<
///
/// Add a cmdlet to construct a command pipeline.
- /// For example, to construct a command string "get-process | sort-object",
+ /// For example, to construct a command string "Get-Process | Sort-Object",
///
- /// PowerShell shell = PowerShell.Create("get-process").AddCommand("sort-object");
+ /// PowerShell shell = PowerShell.Create()
+ /// .AddCommand("Get-Process")
+ /// .AddCommand("Sort-Object");
///
///
///
@@ -984,9 +986,11 @@ public PowerShell AddCommand(string cmdlet)
///
/// Add a cmdlet to construct a command pipeline.
- /// For example, to construct a command string "get-process | sort-object",
+ /// For example, to construct a command string "Get-Process | Sort-Object",
///
- /// PowerShell shell = PowerShell.Create("get-process").AddCommand("sort-object");
+ /// PowerShell shell = PowerShell.Create()
+ /// .AddCommand("Get-Process", true)
+ /// .AddCommand("Sort-Object", true);
///
///
///
@@ -1025,10 +1029,10 @@ public PowerShell AddCommand(string cmdlet, bool useLocalScope)
///
/// Add a piece of script to construct a command pipeline.
- /// For example, to construct a command string "get-process | foreach { $_.Name }"
+ /// For example, to construct a command string "Get-Process | ForEach-Object { $_.Name }"
///
- /// PowerShell shell = PowerShell.Create("get-process").
- /// AddCommand("foreach { $_.Name }", true);
+ /// PowerShell shell = PowerShell.Create()
+ /// .AddScript("Get-Process | ForEach-Object { $_.Name }");
///
///
///
@@ -1064,10 +1068,10 @@ public PowerShell AddScript(string script)
///
/// Add a piece of script to construct a command pipeline.
- /// For example, to construct a command string "get-process | foreach { $_.Name }"
+ /// For example, to construct a command string "Get-Process | ForEach-Object { $_.Name }"
///
- /// PowerShell shell = PowerShell.Create("get-process").
- /// AddCommand("foreach { $_.Name }", true);
+ /// PowerShell shell = PowerShell.Create()
+ /// .AddScript("Get-Process | ForEach-Object { $_.Name }", true);
///
///
///
@@ -1173,10 +1177,11 @@ public PowerShell AddCommand(CommandInfo commandInfo)
///
/// Add a parameter to the last added command.
- /// For example, to construct a command string "get-process | select-object -property name"
+ /// 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");
+ /// PowerShell shell = PowerShell.Create()
+ /// .AddCommand("Get-Process")
+ /// .AddCommand("Select-Object").AddParameter("Property", "Name");
///
///
///
@@ -1378,10 +1383,11 @@ public PowerShell AddParameters(IDictionary parameters)
///
/// Adds an argument to the last added command.
- /// For example, to construct a command string "get-process | select-object name"
+ /// For example, to construct a command string "Get-Process | Select-Object Name"
///
- /// PowerShell shell = PowerShell.Create("get-process").
- /// AddCommand("select-object").AddParameter("name");
+ /// PowerShell shell = PowerShell.Create()
+ /// .AddCommand("Get-Process")
+ /// .AddCommand("Select-Object").AddArgument("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