ConvertTo-Json
Converte un oggetto in una stringa in formato JSON.
Sintassi
ConvertTo-Json
[-InputObject] <Object>
[-Depth <Int32>]
[-Compress]
[<CommonParameters>]
Descrizione
Il cmdlet ConvertTo-Json converte qualsiasi oggetto in una stringa in formato JSON (JavaScript Object Notation). Le proprietà vengono convertite in nomi di campo, i valori di campo vengono convertiti in valori di proprietà e i metodi vengono rimossi.
È quindi possibile usare il cmdlet ConvertFrom-Json per convertire una stringa in formato JSON in un oggetto JSON, facilmente gestito in Windows PowerShell.
Molti siti Web usano JSON anziché XML per serializzare i dati per la comunicazione tra server e applicazioni basate sul Web.
Questo cmdlet è stato introdotto in Windows PowerShell 3.0.
Esempio
Esempio 1
PS C:\> (Get-UICulture).Calendar | ConvertTo-Json
{
"MinSupportedDateTime": "\/Date(-62135596800000)\/",
"MaxSupportedDateTime": "\/Date(253402300799999)\/",
"AlgorithmType": 1,
"CalendarType": 1,
"Eras": [
1
],
"TwoDigitYearMax": 2029,
"IsReadOnly": false
}
Questo esempio usa il cmdlet ConvertTo-Json per convertire un oggetto GregorianCalendar in una stringa in formato JSON.
Esempio 2
PS C:\> @{Account="User01";Domain="Domain01";Admin="True"} | ConvertTo-Json -Compress
{"Admin":"True","Account":"User01","Domain":"Domain01"}
Questo esempio mostra l'effetto dell'uso del -Compress
parametro ConvertTo-Json.
La compressione influisce solo sull'aspetto della stringa, non sulla validità.
Esempio 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
}
Questo esempio usa il cmdlet ConvertTo-Json per convertire un oggetto System.DateTime dal cmdlet Get-Date a una stringa in formato JSON. Il comando usa il cmdlet Select-Object per ottenere tutte le proprietà (*
) dell'oggetto DateTime . L'output mostra la stringa JSON restituita da ConvertTo-Json.
Esempio 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
Questo esempio illustra come usare i cmdlet ConvertTo-Json e ConvertFrom-Json per convertire un oggetto in una stringa JSON e in un oggetto JSON.
Parametri
-Compress
Omette gli spazi vuoti e la formattazione rientrata nella stringa di output.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Depth
Specifica il numero di livelli di oggetti contenuti inclusi nella rappresentazione JSON. Il valore predefinito è 2.
Type: | Int32 |
Position: | Named |
Default value: | 2 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
Specifica gli oggetti da convertire in formato JSON. Immettere una variabile che contiene gli oggetti oppure digitare un comando o un'espressione che ottiene gli oggetti. È anche possibile inviare un oggetto tramite pipe a ConvertTo-Json.
Il parametro InputObject è obbligatorio, ma il relativo valore può essere null ($null
) o una stringa vuota.
Quando l'oggetto di input è $null
, ConvertTo-Json non genera alcun output.
Quando l'oggetto di input è una stringa vuota, ConvertTo-Json restituisce una stringa vuota.
Type: | Object |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Input
È possibile inviare qualsiasi oggetto tramite pipe a ConvertTo-Json.
Output
Note
- Il cmdlet ConvertTo-Json viene implementato usando la classe JavaScriptSerializer.