在PowerShell中了解NewtonSoft

dbc的答案包含有用的背景信息，并且清楚地表明从PowerShell调用NewtonSoft Json.NET库很麻烦。

鉴于PowerShell对JSON解析的内置支持（通过ConvertFrom-Json和ConvertTo-Jsoncmdlet），通常没有理由诉诸第三方库（直接^[1]），但在以下情况下除外：

• 当性能至关重要时。
• 当必须克服PowerShell JSON解析的限制时（缺少对空键名和仅字母大小写不同的键的支持）。
• 当您需要使用Json.NET类型及其方法，而不是使用无方法的“属性袋”[pscustomobject]实例ConvertFrom-Json构造时。

虽然与NewtonSoft的Json.NET直接在PowerShell中的工作是尴尬的，它是可管理的，如果你遵循以下几条规则：

• 缺乏可见的输出并不一定意味着根本没有任何输出：

  • 由于PowerShell中的错误（自v7.0.0-preview.4起），默认情况下，[JValue]实例和[JProperty]包含它们的实例不会产生可见输出；而是访问其（强类型）.Value属性（例如，$nsObj.Array1[0].Value或$nsProp.Value.Value（原文如此））

  • 要输出的字符串表示一个的[JObject]/ [JArray]/ [JProperty]/[JValue]例如，不依赖原样输出（例如$nsObj），使用具有明确的字串.ToString()（例如，$nsObj.ToString()）; 尽管字符串插值（例如"$nsObj"）通常可以正常工作，但[JValue]由于上述错误，它不适用于实例。

  • [JObject][JArray]默认情况下，对象显示其元素的实例属性列表（隐式Format-List应用于对象的枚举）；您可以使用Format-*cmdlet来调整输出形状；例如$nsObj | Format-Table Path, Type。

    • 由于另一个错误（可能具有相同的根本原因），自PowerShell Core 7.0.0-preview.4起，在输入JSON包含数组的情况下，[JObject]实例的默认输出实际上已损坏（打印错误）。format-default : Target type System.Collections.IEnumerator is not a value type or a non-abstract class. (Parameter 'targetType')

• 要用数字索引[JObject]实例，即按索引而不是按名称访问属性，请使用以下惯用法：@($nsObj)[<n>]，其中<n>是所关注的数字索引。

  • $nsObj[<n>]实际上应该可以正常工作，因为与C＃不同，PowerShell将通过接口实现的成员公开为可直接调用的类型成员，因此应该可以访问通过接口实现的数字索引器，但是可能由于此错误而无法访问（自PowerShell Core 7.0起） .0-preview.4）。JObjectIList<JToken>

  • 解决方案基于@(...)PowerShell的array-subexpression运算符，它强制[JObject]实例的枚举产生其[JProperty]成员数组，然后可以通过索引对其进行访问；请注意，这种方法很简单，但是效率不高，因为枚举和构造了aux。发生阵列；但是，鉴于单个JSON对象（而不是array）通常不具有大量属性，因此在实践中这不太可能重要。
    一种基于反射的解决方案可以访问该IList<JToken>接口的数字索引器，但可能更慢。

  • 请注意，.Value可能再次需要基于附加的访问来打印结果（或提取强类型属性值）。

• 通常，不要使用该.GetEnumerator()方法；[JObject]并且[JArray]实例是直接枚举的。

  • 请记住，PowerShell可能会在您不期望的上下文中自动枚举此类实例，尤其是在管道中；值得注意的是，当您将a发送[JObject]到管道时，它的组成部分[JProperty]是单独发送的。

• 使用类似@($nsObj.Array1).Value提取值的数组的原始JSON值（字符串，数字，...） -即[JValue]实例-数组。

下面在上下文中演示了这些技术：

$json = @"
{
    "Array1": [
        "I am string 1 from array1",
        "I am string 2 from array1",
    ],

    "Array2": [
        {
           "Array2Object1Str1": "Object in list, string 1",
           "Array2Object1Str2": "Object in list, string 2"
        }
    ]

}
"@

# Deserialize the JSON text into a hierarchy of nested objects.
# Note: You can omit the target type to let Newtonsoft.Json infer a suitable one.
$nsObj = [Newtonsoft.Json.JsonConvert]::DeserializeObject($json)
# Alternatively, you could more simply use:
#   $nsObj = [Newtonsoft.Json.Linq.JObject]::Parse($json)

# Access the 1st property *as a whole* by *index* (index 0).
@($nsObj)[0].ToString()

# Ditto, with (the typically used) access by property *name*.
$nsObj.Array1.ToString()

# Access a property *value* by name.
$nsObj.Array1[0].Value

# Get an *array* of the *values* in .Array1.
# Note: This assumes that the array elements are JSON primitives ([JValue] instances.
@($nsObj.Array1).Value

# Access a property value of the object contained in .Array2's first element by name:
$nsObj.Array2[0].Array2Object1Str1.Value


# Enumerate the properties of the object contained in .Array2's first element
# Do NOT use .GetEnumerator() here - enumerate the array *itself*
foreach($o in $nsObj.Array2[0]){
  "Path is: $($o.Path)"
  "Parent is: $($o.Parent.ToString())"
}

^{[1] PowerShell Core-但不是Windows PowerShell-当前（v7）实际上在幕后使用NewtonSoft的Json.NET。}