我完全懂你的需求——就是想让自己写的容器类对象，能像原生数组、列表那样直接用ForEach-Object或者foreach循环遍历，不用每次都手动去取内部的隐藏数组对吧？在PowerShell里要实现这个，核心是让你的类提供一个GetEnumerator()方法，因为PowerShell的迭代机制会自动识别这个方法来处理遍历逻辑，和C++、Python里的迭代器思路本质是相通的。

下面给你几种可行的实现方式，从简单到灵活：

方式一：直接返回内部数组的枚举器（最简便） #

这是最快的实现方式，只要在你的容器类里添加一个GetEnumerator()方法，返回隐藏数组的枚举器就行：

class MyContainer {
    # 你的隐藏数组成员
    hidden [String[]]$array = @("apple", "banana", "cherry")

    # 实现GetEnumerator方法，让PowerShell能识别迭代逻辑
    [System.Collections.IEnumerator] GetEnumerator() {
        # 直接返回内部数组的枚举器
        return $this.array.GetEnumerator()
    }
}

测试一下效果：

$myContainer = [MyContainer]::new()
# 用ForEach-Object迭代
$myContainer | ForEach-Object { Write-Host "当前元素: $_" }

# 或者用foreach循环
foreach ($item in $myContainer) {
    Write-Host "foreach循环获取: $_"
}

运行后就能直接遍历到内部数组的元素，完全不用手动去访问$myContainer.array。

方式二：实现泛型IEnumerable接口（类型更安全） #

如果想要更严格的类型控制，比如明确迭代的元素是string类型，可以让你的类实现泛型的IEnumerable<string>接口。不过要注意，这个接口要求同时实现泛型和非泛版的GetEnumerator()方法：

class MyContainer : System.Collections.Generic.IEnumerable[string] {
    hidden [String[]]$array = @("apple", "banana", "cherry")

    # 泛版GetEnumerator，返回强类型的枚举器
    [System.Collections.Generic.IEnumerator[string]] GetEnumerator() {
        # 把数组转成List<string>再拿枚举器，或者直接用数组的泛型枚举器
        return ([System.Collections.Generic.List[string]]$this.array).GetEnumerator()
    }

    # 必须实现的非泛版接口方法，直接调用泛版即可
    [System.Collections.IEnumerator] System.Collections.IEnumerable.GetEnumerator() {
        return $this.GetEnumerator()
    }
}

这种方式的好处是，在迭代时PowerShell会明确知道元素是string类型，避免类型转换的问题，适合对类型安全有要求的场景。

方式三：自定义枚举器（灵活控制迭代逻辑） #

如果你的容器需要特殊的迭代逻辑——比如跳过某些元素、反向遍历、或者动态生成元素——可以自己实现IEnumerator接口，完全控制迭代的过程：

# 自定义枚举器类，实现IEnumerator接口
class ReverseStringEnumerator : System.Collections.IEnumerator {
    hidden [String[]]$items
    hidden [int]$index

    # 构造函数传入要迭代的数组
    ReverseStringEnumerator([String[]]$items) {
        $this.items = $items
        # 初始索引设为数组最后一位，实现反向迭代
        $this.index = $items.Count
    }

    # 获取当前元素
    [object] get_Current() {
        return $this.items[$this.index]
    }

    # 移动到下一个元素（这里是往前移动）
    [bool] MoveNext() {
        $this.index--
        return $this.index -ge 0
    }

    # 重置迭代器到初始状态
    [void] Reset() {
        $this.index = $this.items.Count
    }
}

# 你的容器类，返回自定义枚举器
class MyReverseContainer {
    hidden [String[]]$array = @("apple", "banana", "cherry")

    [System.Collections.IEnumerator] GetEnumerator() {
        # 返回自定义的反向迭代器
        return [ReverseStringEnumerator]::new($this.array)
    }
}

测试这个反向迭代的容器：

$reverseContainer = [MyReverseContainer]::new()
$reverseContainer | ForEach-Object { Write-Host "反向迭代元素: $_" }

运行后会输出cherry、banana、apple，完全按照你自定义的逻辑来迭代。

关键注意点 #

• hidden修饰符不影响迭代：只要GetEnumerator()方法能访问到内部的$array成员就行，隐藏属性只是不让用户直接访问，类内部的方法还是可以正常调用的。
• 实时迭代：如果你的容器类有添加、删除元素的方法，只要内部的$array是实时更新的，迭代器就会拿到最新的内容。
• 兼容性：不管是PowerShell 5.1还是PowerShell 7+，这些实现方式都能正常工作。

内容的提问来源于stack exchange，提问作者NiklasMan