Condividi tramite

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 delimitati da caratteri (CSV) in oggetti 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 csv diventano i nomi delle proprietà aggiunte a ogni nuovo PSObject.

Gli oggetti creati ConvertFrom-Csv sono oggetto 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 dispongono di metodi.

È anche possibile usare i Export-Csv cmdlet e Import-Csv per convertire gli oggetti in stringhe CSV in un file e tornare. Questi cmdlet sono uguali ConvertTo-Csv ai 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 di intestazione della colonna. Ciò significa che si ottiene lo stesso ordine di colonna quando si convertono 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 nella pipeline a ConvertTo-Csv. Il ConvertTo-Csv cmdlet converte gli oggetti di processo in una serie di stringhe CSV. Il ConvertFrom-Csv cmdlet converte le stringhe CSV in versioni CSV degli oggetti del processo originale. Le stringhe CSV vengono salvate nella $P variabile.

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

In questo esempio viene illustrato 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 alla pipeline in ConvertTo-Csv. Il ConvertTo-Csv cmdlet converte l'oggetto date in una serie di stringhe CSV. Il parametro Delimiter viene usato 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 usare 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 è facoltativo in PowerShell v6 e versioni successive. La $Header variabile contiene un'intestazione personalizzata che sostituisce i valori predefiniti seguenti: HasMoreData, JobStateInfo, PSBeginTime, PSEndTime ePSJobTypeName. 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 di servizio

In questo esempio viene illustrato come usare il cmdlet con il ConvertFrom-Csv 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 corrente. Il Get-Service cmdlet invia oggetti del servizio nella pipeline a ConvertTo-Csv. Converte ConvertTo-Csv gli oggetti del 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 corrente.

Quando viene usato il parametro UseCulture , assicurarsi che il separatore di elenco predefinito della cultura corrente 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 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 dati, le colonne di dati rimanenti vengono eliminate. Se si immettono più intestazioni di colonna rispetto alle colonne dati, le intestazioni di colonna aggiuntive vengono create con colonne di dati vuote.

Quando si usa il parametro Intestazione , 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 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 elementi. 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 stringhe CSV tramite pipe 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 usando il ToString() metodo dell'oggetto . Non è possibile esportare i metodi dell'oggetto.