다음을 통해 공유

ConvertTo-Json

  • 참조
모듈:
Microsoft.PowerShell.Utility

개체를 JSON 형식 문자열로 변환합니다.

구문

ConvertTo-Json
              [-InputObject] <Object>
              [-Depth <Int32>]
              [-Compress]
              [<CommonParameters>]

Description

ConvertTo-Json cmdlet은 모든 개체를 JSON(JavaScript Object Notation) 형식의 문자열로 변환합니다. 속성은 필드 이름으로 변환되고 필드 값은 속성 값으로 변환되며 메서드는 제거됩니다.

그런 다음 ConvertFrom-Json cmdlet을 사용하여 JSON 형식 문자열을 Windows PowerShell에서 쉽게 관리할 수 있는 JSON 개체로 변환할 수 있습니다.

많은 웹 사이트에서는 XML 대신 JSON을 사용하여 서버와 웹 기반 앱 간의 통신을 위해 데이터를 직렬화합니다.

이 cmdlet은 Windows PowerShell 3.0에서 도입되었습니다.

예제

예제 1

PS C:\> (Get-UICulture).Calendar | ConvertTo-Json

{
    "MinSupportedDateTime":  "\/Date(-62135596800000)\/",
    "MaxSupportedDateTime":  "\/Date(253402300799999)\/",
    "AlgorithmType":  1,
    "CalendarType":  1,
    "Eras":  [
                 1
             ],
    "TwoDigitYearMax":  2029,
    "IsReadOnly":  false
}

이 예제에서는 ConvertTo-Json cmdlet을 사용하여 GregorianCalendar 개체를 JSON 형식 문자열로 변환합니다.

예제 2

PS C:\> @{Account="User01";Domain="Domain01";Admin="True"} | ConvertTo-Json -Compress

{"Admin":"True","Account":"User01","Domain":"Domain01"}

이 예제에서는 ConvertTo-Json-Compress 매개 변수를 사용하는 효과를 보여줍니다. 압축은 문자열의 모양에만 영향을 주며 유효성은 영향을 받지 않습니다.

예제 3

PS C:\> Get-Date | Select-Object -Property * | ConvertTo-Json

{

    "DisplayHint":  2,
    "DateTime":  "Friday, January 13, 2012 8:06:16 PM",
    "Date":  "\/Date(1326441600000)\/",
    "Day":  13,
    "DayOfWeek":  5,
    "DayOfYear":  13,
    "Hour":  20,
    "Kind":  2,
    "Millisecond":  221,
    "Minute":  6,
    "Month":  1,
    "Second":  16,
    "Ticks":  634620819762218083,
    "TimeOfDay":  {
                      "Ticks":  723762218083,
                      "Days":  0,
                      "Hours":  20,
                      "Milliseconds":  221,
                      "Minutes":  6,
                      "Seconds":  16,
                      "TotalDays":  0.83768775241087956,
                      "TotalHours":  20.104506057861109,
                      "TotalMilliseconds":  72376221.8083,
                      "TotalMinutes":  1206.2703634716668,
                      "TotalSeconds":  72376.22180829999
                  },
    "Year":  2012
}

이 예제에서는 ConvertTo-Json cmdlet을 사용하여 System.DateTime 개체를 Get-Date cmdlet에서 JSON 형식 문자열로 변환합니다. 이 명령은 Select-Object cmdlet을 사용하여 DateTime 개체 속성의 모든(*)를 가져옵니다. 출력에는 ConvertTo-Json 반환된 JSON 문자열이 표시됩니다.

예제 4

PS C:\> Get-Date | Select-Object -Property * | ConvertTo-Json | ConvertFrom-Json

DisplayHint : 2
DateTime    : Saturday, October 13, 2018 3:28:40 AM
Date        : 10/13/2018 12:00:00 AM
Day         : 13
DayOfWeek   : 6
DayOfYear   : 286
Hour        : 3
Kind        : 2
Millisecond : 346
Minute      : 28
Month       : 10
Second      : 40
Ticks       : 636749981203464381
TimeOfDay   : @{Ticks=125203464381; Days=0; Hours=3; Milliseconds=346; Minutes=28; Seconds=40;
              TotalDays=0.14491141710763888; TotalHours=3.4778740105833332; TotalMilliseconds=12520346.4381;
              TotalMinutes=208.67244063500002; TotalSeconds=12520.3464381}
Year        : 2018

이 예제에서는 ConvertTo-Json 및 ConvertFrom-Json cmdlet을 사용하여 개체를 JSON 문자열 및 JSON 개체로 변환하는 방법을 보여 줍니다.

매개 변수

-Compress

출력 문자열에서 공백 및 들여쓰기 서식을 생략합니다.

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Depth

JSON 표현에 포함된 개체의 수준을 지정합니다. 기본값은 2입니다.

형식:Int32
Position:Named
Default value:2
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-InputObject

JSON 형식으로 변환할 개체를 지정합니다. 개체가 포함된 변수를 입력하거나 개체를 가져오는 명령이나 식을 입력합니다. 개체를 convertTo-Json파이프할 수도 있습니다.

InputObject 매개 변수가 필요하지만 해당 값은 null($null) 또는 빈 문자열일 수 있습니다. 입력 개체가 $null경우 ConvertTo-Json 출력을 생성하지 않습니다. 입력 개체가 빈 문자열이면 ConvertTo-Json 빈 문자열을 반환합니다.

형식:Object
Position:0
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

입력

Object

모든 개체를 convertTo-Json파이프할 수 있습니다.

출력

String

참고