Test-Json (Microsoft.PowerShell.Utility) - PowerShell

示例 1：测试对象是否为有效的 JSON

此示例测试输入字符串是否为有效的 JSON 文档。
"{'name': 'Ashley', 'age': 25}" | Test-Json
	示例 2：针对提供的架构测试对象
	此示例采用包含 JSON 架构的字符串，并将其与输入字符串进行比较。
	$schema = @'
  "definitions": {},
  "$schema": "http://json-schema.org/draft-07/schema#",
  "$id": "http://example.com/root.json",
  "type": "object",
  "title": "The Root Schema",
  "required": [
    "name",
    "age"
  "properties": {
    "name": {
      "$id": "#/properties/name",
      "type": "string",
      "title": "The Name Schema",
      "default": "",
      "examples": [
        "Ashley"
      "pattern": "^(.*)$"
    "age": {
      "$id": "#/properties/age",
      "type": "integer",
      "title": "The Age Schema",
      "default": 0,
      "examples": [
"{'name': 'Ashley', 'age': '25'}" | Test-Json -Schema $schema
Test-Json : IntegerExpected: #/age
At line:1 char:37
+ "{'name': 'Ashley', 'age': '25'}" | Test-Json -Schema $schema
+                                     ~~~~~~~~~~~~~~~~~~~~~~~~~
+ CategoryInfo          : InvalidData: (:) [Test-Json], Exception
+ FullyQualifiedErrorId : InvalidJsonAgainstSchema,Microsoft.PowerShell.Commands.TestJsonCommand
False
	在此示例中，我们收到错误，因为架构需要 一个整数来表示年龄 ，但我们测试的 JSON 输入改用字符串值。
有关详细信息，请参阅 JSON 架构。
	示例 3：根据文件中的架构测试对象
	JSON 架构可以使用 关键字引用定义 $ref 。 $ref可以解析为引用另一个文件的 URI。 SchemaFile 参数接受 JSON 架构文件的文本路径，并允许针对此类架构验证 JSON 文件。
在此示例中， schema.json 文件引用 definitions.json。
	Get-Content schema.json
  "description":"A person",
  "type":"object",
  "properties":{
    "name":{
      "$ref":"definitions.json#/definitions/name"
    "hobbies":{
      "$ref":"definitions.json#/definitions/hobbies"
Get-Content definitions.json
  "definitions":{
    "name":{
      "type":"string"
    "hobbies":{
      "type":"array",
      "items":{
        "type":"string"
'{"name": "James", "hobbies": [".NET", "Blogging"]}' | Test-Json -SchemaFile 'schema.json'
	有关详细信息，请参阅 构建复杂架构。
-Json
	指定要测试有效性的 JSON 字符串。 输入一个包含字符串的变量，或键入可获取字符串的命令或表达式。 还可以通过管道将字符串传递给 Test-Json。
Json 参数是必需的。
			Type:String
			Position:1
			Default value:None
		Accept pipeline input:True
		Accept wildcard characters:False
-Schema
	指定要验证 JSON 输入的架构。 如果传递， Test-Json 则验证 JSON 输入是否符合 Schema 参数指定的规范，并且仅当输入符合提供的架构时才返回 $true 。
有关详细信息，请参阅 JSON 架构。
			Type:String
			Position:2
			Default value:None
		Accept pipeline input:False
		Accept wildcard characters:False
-SchemaFile
	指定用于验证 JSON 输入的架构文件。 使用时，Test-Json仅当 JSON 输入符合 SchemaFile 参数指定的文件中定义的架构时，才会返回 $true 。
有关详细信息，请参阅 JSON 架构。
			Type:String
			Position:Named
			Default value:None
		Accept pipeline input:False
		Accept wildcard characters:False
			String
		可以通过管道将 JSON 字符串传递给此 cmdlet。
			Boolean
		如果 JSON 有效，则此 cmdlet 返回 ，否则$false返回 $true 。
	cmdlet Test-Json 是使用 NJsonSchema 类实现的。
自 PowerShell 6 起，PowerShell 对所有 JSON 函数使用 Newtonsoft.Json 程序集。
Newtonsoft 的实现包括 JSON 标准的多个扩展，例如支持注释和使用单引号。 有关功能的完整列表，请参阅 上的 https://www.newtonsoft.com/jsonNewtonsoft 文档。
	JavaScript 和 .NET 中的 JavaScript 对象表示法 (JSON) 简介
	其他 JSON 架构详细信息
	ConvertTo-Json
	Invoke-WebRequest
	Invoke-RestMethod