PowerShell - PSObject属性成为具有追加到集合的下一个属性的名称的集合

在 PowerShell 中，PSObject 是一个基础类，用于表示 PowerShell 中的对象。每个 PSObject 都有一个属性集合，这些属性可以通过添加新的 NoteProperty 来扩展。当你向 PSObject 添加一个新的属性时，如果该属性的名称与现有的属性名称相同，PowerShell 会自动将新属性追加到集合中，并且新属性的名称会变成原始名称加上一个递增的数字。

基础概念

• PSObject: PowerShell 中的一个基础类，用于封装 .NET 对象并添加额外的属性和方法。
• NoteProperty: PowerShell 中的一种属性类型，用于添加自定义数据到对象。

相关优势

• 灵活性: 可以动态地向对象添加或修改属性。
• 扩展性: 允许在不修改原始对象类的情况下增加功能。

类型

• PSProperty: 表示 PSObject 的一个属性。
• NoteProperty: 一种 PSProperty，用于存储简单的键值对。

应用场景

• 动态数据处理: 当你需要根据运行时的条件向对象添加属性时。
• 报告生成: 创建包含动态信息的自定义报告。

遇到的问题及原因

问题: 当你尝试向 PSObject 添加一个已存在的属性时，新属性的名称变成了原始名称加上一个递增的数字。

原因: 这是 PowerShell 的设计行为，以避免属性名称冲突。当检测到同名属性时，PowerShell 会自动为新属性生成一个唯一的名称。

如何解决这些问题

如果你希望避免属性名称的自动更改，可以采取以下措施：

1. 检查属性是否存在: 在添加属性之前，先检查该属性是否已经存在。

$myObject = New-Object PSObject
$propertyName = "MyProperty"

if (-not ($myObject.PSObject.Properties.Name -contains $propertyName)) {
    $myObject | Add-Member -MemberType NoteProperty -Name $propertyName -Value "SomeValue"
} else {
    Write-Warning "Property '$propertyName' already exists on the object."
}

1. 使用不同的属性名称: 如果可能，使用唯一的属性名称。
2. 使用哈希表: 对于动态属性集合，可以考虑使用哈希表（Hashtable），它允许键重复。

$myHashTable = @{}
$propertyName = "MyProperty"

# 添加或更新属性
$myHashTable[$propertyName] = "SomeValue"

通过这些方法，你可以更好地控制 PSObject 的属性添加过程，避免不必要的名称更改。