Megosztás a következőn keresztül:

ConvertTo-Csv

Modul:
Microsoft.PowerShell.Utility Module

Az objektumokat vesszővel tagolt (CSV) karakterláncok sorozatává alakítja.

Syntax

Delimiter (Alapértelmezett) 

ConvertTo-Csv
    [-InputObject] <psobject>
    [[-Delimiter] <char>]
    [-NoTypeInformation]
    [<CommonParameters>]

UseCulture 

ConvertTo-Csv
    [-InputObject] <psobject>
    [-UseCulture]
    [-NoTypeInformation]
    [<CommonParameters>]

Description

A ConvertTo-CSV parancsmag vesszővel tagolt (CSV) sztringek sorozatát adja vissza, amelyek az Ön által elküldött objektumokat jelölik. Ezután a ConvertFrom-Csv parancsmaggal újból létrehozhat objektumokat a CSV-sztringekből. A CSV-ből konvertált objektumok az eredeti objektumok sztringértékei, amelyek tulajdonságértékeket és metódusokat nem tartalmaznak.

A Export-Csv parancsmaggal csv-sztringekké alakíthatja az objektumokat. Export-CSV hasonló a ConvertTo-CSV, kivéve, hogy a CSV-sztringeket fájlba menti.

A ConvertTo-CSV parancsmag olyan paraméterekkel rendelkezik, amelyek nem vesszőt, vagy az aktuális kultúrát használják elválasztóként.

Példák

1. példa: Objektum konvertálása CSV-vé

Ez a példa egy Process objektumot KONVERTÁL CSV-sztringgé.

Get-Process -Name 'PowerShell' | ConvertTo-Csv -NoTypeInformation

"Name","SI","Handles","VM","WS","PM","NPM","Path","Company","CPU","FileVersion", ...
"powershell","11","691","2204036739072","175943680","132665344","33312", ...

A Get-Process parancsmag lekéri a Folyamat objektumot, és a Név paramétert használja a PowerShell-folyamat megadásához. A folyamatobjektumot a rendszer elküldi a folyamaton a ConvertTo-CSV parancsmagnak. A ConvertTo-CSV parancsmag CSV-sztringekké alakítja az objektumot. A NoTypeInformation paraméter eltávolítja a #TYPE információs fejlécet a CSV-kimenetből.

2. példa: DateTime-objektum konvertálása CSV-vé

Ez a példa egy DateTime objektumot KONVERTÁL CSV-sztringgé.

$Date = Get-Date
ConvertTo-Csv -InputObject $Date -Delimiter ';' -NoTypeInformation

"DisplayHint";"DateTime";"Date";"Day";"DayOfWeek";"DayOfYear";"Hour";"Kind";"Millisecond";"Minute";"Month";"Second";"Ticks";"TimeOfDay";"Year"
"DateTime";"Friday, January 4, 2019 14:40:51";"1/4/2019 00:00:00";"4";"Friday";"4";"14";"Local";"711";"40";"1";"51";"636822096517114991";"14:40:51.7114991";"2019"

A Get-Date parancsmag lekéri a DateTime objektumot, és menti a $Date változóba. A ConvertTo-Csv parancsmag sztringekké alakítja a DateTime objektumot. Az InputObject paraméter a változóban tárolt $Date objektumot használja. A elválasztó paraméter pontosvesszőt ad meg a sztringértékek elválasztásához. A NoTypeInformation paraméter eltávolítja a #TYPE információs fejlécet a CSV-kimenetből.

3. példa: A PowerShell-eseménynapló konvertálása CSV-vé

Ez a példa a PowerShell Windows-eseménynaplóját CSV-sztringek sorozatává alakítja.

(Get-Culture).TextInfo.ListSeparator
Get-WinEvent -LogName 'Windows PowerShell' | ConvertTo-Csv -UseCulture -NoTypeInformation

,
"Message","Id","Version","Qualifiers","Level","Task","Opcode","Keywords","RecordId", ...
"Error Message = System error","403",,"0","4","4",,"36028797018963968","46891","PowerShell", ...

A Get-Culture parancsmag a Beágyazott tulajdonságokat TextInfo és ListSeparator használja, és megjeleníti az aktuális kultúra alapértelmezett listaelválasztóját. A Get-WinEvent parancsmag lekéri az eseménynapló-objektumokat, és a LogName paraméter használatával adja meg a naplófájl nevét. Az eseménynapló-objektumok le lesznek küldve a folyamaton a ConvertTo-Csv parancsmagba. A ConvertTo-Csv parancsmag az eseménynapló-objektumokat CSV-sztringek sorozatává alakítja. A UseCulture paraméter az aktuális kultúra alapértelmezett listaelválasztóját használja elválasztóként. A NoTypeInformation paraméter eltávolítja a #TYPE információs fejlécet a CSV-kimenetből.

Paraméterek

-Delimiter

Megadja a CSV-sztringek tulajdonságértékeinek elválasztásához használt elválasztójelet. Az alapértelmezett érték egy vessző (,). Adjon meg egy karaktert, például kettőspontot (:). Ha pontosvesszőt (;) szeretne megadni, akkor azt idézőjelek közé kell foglalnia.

Paramétertulajdonságok

Típus:Char
Alapértelmezett érték:comma (,)
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

Delimiter
Position:1
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-InputObject

Megadja a CSV-sztringekké konvertált objektumokat. Adjon meg egy változót, amely tartalmazza az objektumokat, vagy írjon be egy parancsot vagy kifejezést, amely lekéri az objektumokat. Az objektumokat ConvertTo-CSV-ba is továbbíthatja.

Paramétertulajdonságok

Típus:PSObject
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:0
Kötelező:True
Folyamatból származó érték:True
Folyamatból származó érték tulajdonságnév alapján:True
Fennmaradó argumentumokból származó érték:False

-NoTypeInformation

Eltávolítja a #TYPE információs fejlécet a kimenetből. Ez a paraméter lett az alapértelmezett a PowerShell 6.0-ban, és a visszamenőleges kompatibilitás érdekében tartalmazza.

Paramétertulajdonságok

Típus:SwitchParameter
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False
Aliasok:NTI

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-UseCulture

Az aktuális kultúra listaelválasztót használja elválasztó elemként. Egy kultúra listaelválasztójának megkereséséhez használja a következő parancsot: (Get-Culture).TextInfo.ListSeparator.

Paramétertulajdonságok

Típus:SwitchParameter
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

UseCulture
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

CommonParameters

Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.

Bevitelek

PSObject

Bármilyen objektumot, amely rendelkezik Extended Type System (ETS) adapterrel, átirányíthatja a ConvertTo-CSV.

Kimenetek

String

A CSV-kimenet sztringek gyűjteményeként lesz visszaadva.

Jegyzetek

CSV formátumban minden objektumot a tulajdonság értékének vesszővel tagolt listája jelöl. A tulajdonságértékek sztringekké alakulnak az objektum ToString() metódusával. A sztringeket a tulajdonságérték neve jelöli. ConvertTo-CSV nem exportálja az objektum metódusát.

A CSV-sztringek kimenete a következő:

  • Alapértelmezés szerint az első sztring tartalmazza a #TYPE információs fejlécet, majd az objektumtípus teljes nevét. Például #TYPE System.Diagnostics.Process.
  • Ha NoTypeInformation van használva, az első sztring tartalmazza az oszlopfejléceket. A fejlécek vesszővel tagolt listaként tartalmazzák az első objektum tulajdonságneveit.
  • A többi sztring az egyes objektumok tulajdonságértékeinek vesszővel tagolt listáját tartalmazza.

Ha több objektumot küld el a ConvertTo-CSV, ConvertTo-CSV az első beküldendő objektum tulajdonságai alapján rendeli meg a sztringeket. Ha a többi objektum nem rendelkezik a megadott tulajdonságok egyikével, akkor az objektum tulajdonságértéke Null, amelyet két egymást követő vessző jelöl. Ha a többi objektum további tulajdonságokkal rendelkezik, a rendszer figyelmen kívül hagyja ezeket a tulajdonságértékeket.