ConvertFrom-Csv

  • Riferimento
Modulo:
Microsoft.PowerShell.Utility

Converte le proprietà dell'oggetto in formato CSV (Character-Separated Value) in versioni CSV degli oggetti originali.

Sintassi

ConvertFrom-Csv
                [[-Delimiter] <Char>]
                [-InputObject] <PSObject[]>
                [-Header <String[]>]
                [<CommonParameters>]
ConvertFrom-Csv
                -UseCulture
                [-InputObject] <PSObject[]>
                [-Header <String[]>]
                [<CommonParameters>]

Descrizione

Il ConvertFrom-Csv cmdlet converte i dati con valori delimitati da caratteri (CSV) in oggetti di tipo PSObject per ogni riga di dati CSV. I nuovi oggetti vengono scritti nella pipeline nell'ordine in cui vengono letti dai dati CSV. I valori nella riga dell'intestazione di colonna del file CSV diventano i nomi delle proprietà aggiunte a ogni nuovo PSObject.

Gli oggetti creati ConvertFrom-Csv sono oggetto di tipo PSObject per ogni riga nel file CSV. I valori delle proprietà degli oggetti CSV sono versioni in formato stringa dei valori delle proprietà degli oggetti originali. Le versioni CSV degli oggetti non hanno metodi.

È anche possibile usare i Export-Csv cmdlet e Import-Csv per convertire gli oggetti in stringhe CSV in un file e indietro. Questi cmdlet sono gli stessi dei ConvertTo-Csv cmdlet e ConvertFrom-Csv , ad eccezione del fatto che salvano le stringhe CSV in un file.

Il tipo PSObject mantiene l'ordine delle proprietà nell'ordine delle intestazioni di colonna. Ciò significa che si ottiene lo stesso ordine di colonna quando si convertono nuovamente gli oggetti in formato CSV.

Esempio

Esempio 1: Convertire i processi nel computer locale in formato CSV

In questo esempio viene illustrato come convertire i processi nel computer locale in formato CSV e quindi ripristinarli in formato oggetto.

$P = Get-Process | ConvertTo-Csv
$P | ConvertFrom-Csv

Il Get-Process cmdlet invia i processi verso il basso della pipeline a ConvertTo-Csv. Il ConvertTo-Csv cmdlet converte gli oggetti processo in una serie di stringhe CSV. Il ConvertFrom-Csv cmdlet converte le stringhe CSV in versioni CSV degli oggetti processo originali. Le stringhe CSV vengono salvate nella $P variabile .

Esempio 2: Convertire un oggetto dati in formato CSV e quindi in formato oggetto CSV

Questo esempio illustra come convertire un oggetto dati in formato CSV e quindi in formato oggetto CSV.

$Date = Get-Date | ConvertTo-Csv -Delimiter ';'
ConvertFrom-Csv -InputObject $Date -Delimiter ';'

Il primo comando usa Get-Date per inviare la data e l'ora correnti verso il basso della pipeline a ConvertTo-Csv. Il ConvertTo-Csv cmdlet converte l'oggetto date in una serie di stringhe CSV. Il parametro Delimiter viene utilizzato per specificare un delimitatore punto e virgola. Le stringhe vengono salvate nella $Date variabile .

Esempio 3: Usare il parametro di intestazione per modificare i nomi delle proprietà

In questo esempio viene illustrato come utilizzare il parametro Header di ConvertFrom-Csv per modificare i nomi delle proprietà nell'oggetto importato risultante.

$J = Start-Job -ScriptBlock { Get-Process } | ConvertTo-Csv  -NoTypeInformation
$Header = 'State', 'MoreData', 'StatusMessage', 'Location', 'Command',
          'StateInfo', 'Finished', 'InstanceId', 'Id', 'Name', 'ChildJobs',
          'BeginTime', 'EndTime', 'JobType', 'Output', 'Error', 'Progress',
          'Verbose', 'Debug', 'Warning', 'Information'
# Delete the default header from $J
$J = $J[1..($J.count - 1)]
$J | ConvertFrom-Csv -Header $Header

State         : Running
MoreData      : True
StatusMessage :
Location      : localhost
Command       : Get-Process
StateInfo     : Running
Finished      : System.Threading.ManualResetEvent
InstanceId    : a259eb63-6824-4b97-a033-305108ae1c2e
Id            : 1
Name          : Job1
ChildJobs     : System.Collections.Generic.List`1[System.Management.Automation.Job]
BeginTime     : 12/20/2018 18:59:57
EndTime       :
JobType       : BackgroundJob
Output        : System.Management.Automation.PSDataCollection`1[System.Management.Automation.PSObject]
Error         : System.Management.Automation.PSDataCollection`1[System.Management.Automation.ErrorRecord]
Progress      : System.Management.Automation.PSDataCollection`1[System.Management.Automation.ProgressRecord]
Verbose       : System.Management.Automation.PSDataCollection`1[System.Management.Automation.VerboseRecord]
Debug         : System.Management.Automation.PSDataCollection`1[System.Management.Automation.DebugRecord]
Warning       : System.Management.Automation.PSDataCollection`1[System.Management.Automation.WarningRecord]
Information   : System.Management.Automation.PSDataCollection`1[System.Management.Automation.InformationRecord]

Il Start-Job cmdlet avvia un processo in background che esegue Get-Process. Un oggetto processo viene inviato alla pipeline ConvertTo-Csv e convertito in una stringa CSV. Il parametro NoTypeInformation rimuove l'intestazione delle informazioni sul tipo dall'output CSV ed è facoltativa in PowerShell v6 e versioni successive. La $Header variabile contiene un'intestazione personalizzata che sostituisce i valori predefiniti seguenti: HasMoreData, JobStateInfo, PSBeginTime, P edizione Standard ndTime e PSJobTypeName. La $J variabile contiene la stringa CSV e viene usata per rimuovere l'intestazione predefinita. Il ConvertFrom-Csv cmdlet converte la stringa CSV in un PSCustomObject e usa il parametro Header per applicare la $Header variabile.

Esempio 4: Convertire stringhe CSV di oggetti servizio

In questo esempio viene illustrato come usare il ConvertFrom-Csv cmdlet con il parametro UseCulture .

(Get-Culture).TextInfo.ListSeparator
$Services = (Get-Service | ConvertTo-Csv)
ConvertFrom-Csv -InputObject $Services -UseCulture

Il Get-Culture cmdlet usa le proprietà annidate TextInfo e ListSeparator per ottenere il separatore di elenco predefinito delle impostazioni cultura correnti. Il Get-Service cmdlet invia gli oggetti del servizio nella pipeline a ConvertTo-Csv. ConvertTo-Csv Converte gli oggetti servizio in una serie di stringhe CSV. Le stringhe CSV vengono archiviate nella $Services variabile . Il ConvertFrom-Csv cmdlet usa il parametro InputObject e converte le stringhe CSV dalla $Services variabile . Il parametro UseCulture usa il separatore di elenco predefinito delle impostazioni cultura correnti.

Quando si usa il parametro UseCulture , assicurarsi che il separatore di elenco predefinito delle impostazioni cultura correnti corrisponda al delimitatore usato nelle stringhe CSV. In caso contrario, ConvertFrom-Csv non è possibile generare oggetti dalle stringhe CSV.

Parametri

-Delimiter

Specifica il delimitatore che separa i valori delle proprietà nelle stringhe CSV. Il valore predefinito è una virgola (,). Immettere un carattere, ad esempio due punti (:). Per specificare un punto e virgola (;) racchiuderlo tra virgolette singole.

Se si specifica un carattere diverso dal delimitatore di stringa effettivo nel file, ConvertFrom-Csv non è possibile creare gli oggetti dalle stringhe CSV e restituire le stringhe CSV.

Type:Char
Position:1
Default value:comma (,)
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Header

Specifica una riga di intestazioni di colonna per la stringa importata. L'intestazione di colonna determina i nomi delle proprietà degli oggetti creati da ConvertFrom-Csv.

Immettere le intestazioni di colonna come elenco delimitato da caratteri. non racchiudere la stringa di intestazione tra virgolette. Racchiudere ogni intestazione di colonna tra virgolette singole.

Se si immettono meno intestazioni di colonna rispetto alle colonne di dati, le colonne di dati rimanenti vengono eliminate. Se si immettono più intestazioni di colonna rispetto alle colonne di dati, le intestazioni di colonna aggiuntive vengono create con colonne di dati vuote.

Quando si usa il parametro Header , omettere la stringa di intestazione di colonna dalle stringhe CSV. In caso contrario, questo cmdlet crea un oggetto aggiuntivo dagli elementi nella riga di intestazione.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Specifica le stringhe CSV da convertire in oggetti. Immettere una variabile che contiene le stringhe CSV oppure digitare un comando o le espressioni che ottengono le stringhe CSV. È anche possibile inviare tramite pipe le stringhe CSV a ConvertFrom-Csv.

Type:PSObject[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-UseCulture

Usa il separatore di elenco per le impostazioni cultura correnti come delimitatore di elemento. Per trovare il separatore di elenco per le impostazioni cultura, usare il comando seguente: (Get-Culture).TextInfo.ListSeparator.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

Input

String

È possibile inviare tramite pipe stringhe CSV a questo cmdlet.

Output

PSObject

Questo cmdlet restituisce gli oggetti descritti dalle proprietà nelle stringhe CSV.

Note

In formato CSV, ogni oggetto è rappresentato da un elenco delimitato da caratteri dei valori delle proprietà dell'oggetto. I valori delle proprietà vengono convertiti in stringhe utilizzando il ToString() metodo dell'oggetto . Non è possibile esportare i metodi dell'oggetto.