ConvertFrom-Json
JSON biçimli bir dizeyi özel bir nesneye dönüştürür.
Syntax
Default (Varsayılan)
ConvertFrom-Json
[-InputObject] <String>
[<CommonParameters>]
Description
ConvertFrom-Json cmdlet'i JavaScript Nesne Gösterimi (JSON) biçimli dizeyi, JSON dizesindeki her alan için bir özelliği olan özel PSObject veya Hashtable nesnesine dönüştürür.
JSON, web siteleri tarafından nesnelerin metinsel gösterimini sağlamak için yaygın olarak kullanılır. Cmdlet, JSON dizesinin her satırını işlerken özellikleri yeni nesneye ekler.
JSON standardı, PSObject ve Hashtable türlerinde yasaklanan yinelenen anahtar adlara izin verir. Örneğin, JSON dizesi yinelenen anahtarlar içeriyorsa, bu cmdlet tarafından yalnızca son anahtar kullanılır. Aşağıdaki diğer örneklere bakın.
Herhangi bir nesneden JSON dizesi oluşturmak için ConvertTo-Json cmdlet'ini kullanın.
Bu cmdlet PowerShell 3.0'da kullanıma sunulmuştur.
Uyarı
Windows PowerShell 5.1'de ConvertFrom-Json bir JSON açıklamasıyla karşılaştığında bir hata döndürür. PowerShell 6 ve üzeri sürümlerde cmdlet açıklamaları olan JSON'ı destekler. JSON yorumları, cmdlet tarafından üretilen nesne çıktılarında yakalanmaz. Daha fazla bilgi için about_Comments makalesinin JSON açıklamaları bölümüne bakın.
Örnekler
Örnek 1: DateTime nesnesini JSON nesnesine dönüştürme
Bu komut ConvertTo-Json ve ConvertFrom-Json cmdlet'lerini kullanarak cmdlet'inden Get-Date nesnesini bir JSON nesnesine ve ardından PSCustomObjectdönüştürür.
Get-Date | Select-Object -Property * | ConvertTo-Json | ConvertFrom-Json
DisplayHint : 2
DateTime : Friday, January 13, 2012 8:06:31 PM
Date : 1/13/2012 8:00:00 AM
Day : 13
DayOfWeek : 5
DayOfYear : 13
Hour : 20
Kind : 2
Millisecond : 400
Minute : 6
Month : 1
Second : 31
Ticks : 634620819914009002
TimeOfDay : @{Ticks=723914009002; Days=0; Hours=20; Milliseconds=400; Minutes=6; Seconds=31; TotalDays=0.83786343634490734; TotalHours=20.108722472277776; TotalMilliseconds=72391400.900200009; TotalMinutes=1206.5233483366667;TotalSeconds=72391.4009002}
Year : 2012
Örnek, Select-Object nesnesinin tüm özelliklerini almak için cmdlet'ini kullanır.
ConvertTo-Json nesnesini JSON nesnesi olarak biçimlendirilmiş bir dizeye dönüştürmek için cmdlet'ini ve JSON biçimli dizeyi ConvertFrom-Json nesnesine dönüştürmek için cmdlet'ini kullanır.
Örnek 2: Web hizmetinden JSON dizeleri alma ve bunları PowerShell nesnelerine dönüştürme
Bu komut, bir web hizmetinden JSON dizeleri almak için Invoke-WebRequest cmdlet'ini kullanır ve ardından JSON içeriğini PowerShell'de yönetilebilen nesnelere dönüştürmek için ConvertFrom-Json cmdlet'ini kullanır.
# Ensures that Invoke-WebRequest uses TLS 1.2
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
$j = Invoke-WebRequest 'https://api.github.com/repos/PowerShell/PowerShell/issues' |
ConvertFrom-Json
JSON içeriğini otomatik olarak nesnelere dönüştüren Invoke-RestMethod cmdlet'ini de kullanabilirsiniz.
Örnek 3: JSON dizesini özel nesneye dönüştürme
Bu örnekte bir JSON dosyasını PowerShell özel nesnesine dönüştürmek için ConvertFrom-Json cmdlet'inin nasıl kullanılacağı gösterilmektedir.
Get-Content -Raw JsonFile.json | ConvertFrom-Json
Komut, dizeleri bir JSON dosyasına almak için Get-Content cmdlet'ini kullanır.
Raw parametresi, dosyanın tamamını tek bir JSON nesnesi olarak döndürür. Ardından sınırlanmış dizeyi özel bir nesneye dönüştüren ConvertFrom-Json cmdlet'ine göndermek için işlem hattı işlecini kullanır.
Parametreler
-InputObject
JSON nesnelerine dönüştürülecek JSON dizelerini belirtir. Dizeyi içeren bir değişken girin veya dizeyi alan bir komut veya ifade yazın. Bir metni ConvertFrom-Json'e de yöneltebilirsiniz.
InputObject parametresi gereklidir, ancak değeri boş bir dize olabilir. Giriş nesnesi boş bir dize olduğunda, ConvertFrom-Json herhangi bir çıkış oluşturmaz.
InputObject değeri $nullolamaz.
Parametre özellikleri
| Tür: | String |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | 0 |
| Zorunlu: | True |
| İşlem hattından gelen değer: | True |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
CommonParameters
Bu cmdlet yaygın parametreleri destekler: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction ve -WarningVariable. Daha fazla bilgi için bkz. about_CommonParameters.
Girişler
String
JSON dizesini ConvertFrom-Json'a yönlendirebilirsiniz.
Çıkışlar
PSCustomObject
Notlar
ConvertFrom-Json cmdlet'i JavaScriptSerializer sınıfıkullanılarak uygulanır.
PSObject türü, JSON dizesinde gösterildiği gibi özelliklerin sırasını korur. Anahtar-değer çiftleri Hashtable JSON dizesinde sunulan sırayla eklenirken Hashtable nesneleri bu sırayı korumaz.
