From bcd1e697d65d9604ca90c196ca19302a816630ba Mon Sep 17 00:00:00 2001
From: Dongbo Wang <dongbow@microsoft.com>
Date: Fri, 9 Oct 2026 09:37:48 -0700
Subject: [PATCH] Treat `StringCollection` as a list collection with the
 `String` element type (#28141)

---
 .../engine/CompiledCommandParameter.cs        |  8 ++
 .../Parser/ParameterBinding.Tests.ps1         | 78 +++++++++++++++++++
 2 files changed, 86 insertions(+)

diff --git a/src/System.Management.Automation/engine/CompiledCommandParameter.cs b/src/System.Management.Automation/engine/CompiledCommandParameter.cs
index d2ca1aedd..1f3d1667c 100644
--- a/src/System.Management.Automation/engine/CompiledCommandParameter.cs
+++ b/src/System.Management.Automation/engine/CompiledCommandParameter.cs
@@ -4,6 +4,7 @@
 using System.Collections;
 using System.Collections.Generic;
 using System.Collections.ObjectModel;
+using System.Collections.Specialized;
 using System.Linq;
 using System.Reflection;
 
@@ -623,6 +624,13 @@ namespace System.Management.Automation
                 return;
             }
 
+            if (typeof(StringCollection).IsAssignableFrom(type))
+            {
+                ParameterCollectionType = ParameterCollectionType.IList;
+                ElementType = typeof(string);
+                return;
+            }
+
             bool implementsIList = (type.GetInterface(nameof(IList)) != null);
 
             // Look for class Collection<T>.  Collection<T> implements IList, and also IList
diff --git a/test/powershell/Language/Parser/ParameterBinding.Tests.ps1 b/test/powershell/Language/Parser/ParameterBinding.Tests.ps1
index 493ea9083..54a66d59a 100644
--- a/test/powershell/Language/Parser/ParameterBinding.Tests.ps1
+++ b/test/powershell/Language/Parser/ParameterBinding.Tests.ps1
@@ -472,3 +472,81 @@ Describe 'Roundtrippable Conversions for Bare-string Numeric Literals passed to
         Invoke-Expression "Test-AdvancedStringValue -Value $Argument" | Should -BeExactly $Argument
     }
 }
+
+Describe 'Scalar PSObject binding to non-generic IList parameters' -Tags CI {
+    BeforeAll {
+        $typeDefinition = @'
+using System.Collections;
+using System.Collections.Specialized;
+using System.Management.Automation;
+
+namespace ScalarPSObjectCollectionBinding
+{
+    public sealed class UntypedList : CollectionBase
+    {
+        public object this[int index]
+        {
+            get => List[index];
+            set => List[index] = value;
+        }
+    }
+
+    [Cmdlet(VerbsDiagnostic.Test, "ScalarStringCollectionBinding")]
+    [OutputType(typeof(string))]
+    public sealed class TestScalarStringCollectionBindingCommand : PSCmdlet
+    {
+        [Parameter(Mandatory = true)]
+        public StringCollection Value { get; set; }
+
+        protected override void ProcessRecord()
+        {
+            WriteObject(Value, enumerateCollection: true);
+        }
+    }
+
+    [Cmdlet(VerbsDiagnostic.Test, "ScalarUntypedListBinding")]
+    public sealed class TestScalarUntypedListBindingCommand : PSCmdlet
+    {
+        [Parameter(Mandatory = true)]
+        public UntypedList Value { get; set; }
+
+        protected override void ProcessRecord()
+        {
+            WriteObject(Value[0] is PSObject);
+            WriteObject(((PSObject)Value[0]).Properties["Extra"].Value);
+        }
+    }
+}
+'@
+
+        $types = Add-Type -PassThru -TypeDefinition $typeDefinition
+        Import-Module $types[0].Assembly
+    }
+
+    It 'binds a scalar PSObject wrapping a string to StringCollection' {
+        $value = @('expected', 'expected') | Select-Object -Unique
+
+        $value.GetType().FullName | Should -BeExactly 'System.String'
+        $value -is [System.Management.Automation.PSObject] | Should -BeTrue
+        Test-ScalarStringCollectionBinding -Value $value | Should -BeExactly 'expected'
+    }
+
+    It 'binds multiple PSObjects wrapping strings to StringCollection' {
+        $value = @('first', 'second') | Select-Object -Unique
+
+        $value | ForEach-Object {
+            $_.GetType().FullName | Should -BeExactly 'System.String'
+            $_ -is [System.Management.Automation.PSObject] | Should -BeTrue
+        }
+
+        Test-ScalarStringCollectionBinding -Value $value | Should -BeExactly @('first', 'second')
+    }
+
+    It 'preserves ETS members when the non-generic IList element type is unknown' {
+        $value = 'expected' | Add-Member -NotePropertyName Extra -NotePropertyValue 'preserved' -PassThru
+
+        $value -is [System.Management.Automation.PSObject] | Should -BeTrue
+        $result = @(Test-ScalarUntypedListBinding -Value $value)
+        $result | Should -BeExactly @($true, 'preserved')
+    }
+}