ConvertFrom-Csv

ConvertFrom-Csv
    [-InputObject] <psobject[]>
    [[-Delimiter] <char>]
    [-Header <string[]>]
    [<CommonParameters>]

ConvertFrom-Csv
    [-InputObject] <psobject[]>
    -UseCulture
    [-Header <string[]>]
    [<CommonParameters>]

L’applet ConvertFrom-Csv de commande crée des objets à partir de chaînes de longueur variable CSV générées par l’applet ConvertTo-Csv de commande.

Vous pouvez utiliser les paramètres de cette applet de commande pour spécifier la ligne d’en-tête de colonne, qui détermine les noms de propriété des objets résultants, pour spécifier le délimiteur d’élément ou pour demander à cette applet de commande d’utiliser le séparateur de liste de la culture actuelle en tant que délimiteur.

Les objets créés ConvertFrom-Csv sont des versions CSV des objets d’origine. Les valeurs de propriété des objets CSV sont des versions de chaîne des valeurs de propriété des objets d’origine. Les versions CSV des objets n’ont pas de méthode.

Vous pouvez également utiliser les applets de Export-Csv commande et Import-Csv pour convertir des objets en chaînes CSV dans un fichier (et inversement). Ces applets de commande sont identiques aux applets de commande ConvertTo-Csv et ConvertFrom-Csv, sauf qu’elles enregistrent les chaînes CSV dans un fichier.

Cet exemple montre comment convertir les processus sur l’ordinateur local au format CSV, puis les restaurer au format objet.

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

L’applet de commande Get-Process envoie les processus vers le bas du pipeline à ConvertTo-Csv. L’applet de commande ConvertTo-Csv convertit les objets de processus en une série de chaînes CSV. L’applet de commande ConvertFrom-Csv convertit les chaînes CSV en versions CSV des objets de processus d’origine. Les chaînes CSV sont enregistrées dans la variable $P.

Cet exemple montre comment convertir un objet de données au format CSV, puis au format objet CSV.

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

La première commande utilise Get-Date pour envoyer la date et l’heure actuelles du pipeline à ConvertTo-Csv. L’applet de commande ConvertTo-Csv convertit l’objet de date en une série de chaînes CSV. Le paramètre délimiteur est utilisé pour spécifier un délimiteur point-virgule. Les chaînes sont enregistrées dans la variable $Date.

Cet exemple montre comment utiliser le paramètre Header de ConvertFrom-Csv pour modifier les noms des propriétés dans l’objet importé résultant.

$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]

Le cmdlet Start-Job démarre une tâche d’arrière-plan qui exécute Get-Process. Un objet de travail est envoyé vers le bas du pipeline pour ConvertTo-Csv et converti en chaîne CSV. Le paramètre NoTypeInformation supprime l’en-tête d’informations de type de la sortie CSV et est facultatif dans PowerShell Core. La variable $Header contient un en-tête personnalisé qui remplace les valeurs par défaut suivantes : HasMoreData, JobStateInfo, PSBeginTime, PSEndTimeet PSJobTypeName. La variable $J contient la chaîne CSV et est utilisée pour supprimer l’en-tête par défaut. L’applet de commande ConvertFrom-Csv convertit la chaîne CSV en PSCustomObject et utilise le paramètre Header pour appliquer la variable $Header.

Cet exemple montre comment utiliser l’applet de commande ConvertFrom-Csv avec le paramètre UseCulture.

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

L’applet de commande Get-Culture utilise les propriétés imbriquées TextInfo et ListSeparator pour obtenir le séparateur de liste par défaut de la culture actuelle. L’applet de commande Get-Service envoie des objets de service vers le bas du pipeline à ConvertTo-Csv. Le ConvertTo-Csv convertit les objets de service en une série de chaînes CSV. Les chaînes CSV sont stockées dans la variable $Services. L’applet de commande ConvertFrom-Csv utilise le paramètre InputObject et convertit les chaînes CSV de la variable $Services. Le paramètre UseCulture utilise le séparateur de liste par défaut de la culture actuelle.

Lorsque le paramètre UseCulture est utilisé, assurez-vous que le séparateur de liste par défaut de la culture actuelle correspond au délimiteur utilisé dans les chaînes CSV. Sinon, impossible ConvertFrom-Csv de générer des objets à partir des chaînes CSV.

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

Vous pouvez diriger des chaînes CSV vers cette applet de commande.

Cette applet de commande retourne les objets décrits par les propriétés dans les chaînes CSV.

Étant donné que les objets importés sont des versions CSV du type d’objet, ils ne sont pas reconnus et mis en forme par les entrées de formatage de type PowerShell qui mettent en forme les versions non CSV du type d’objet.

Au format CSV, chaque objet est représenté par une liste de valeurs de propriété de l’objet, séparées par des virgules. Les valeurs de propriété sont converties en chaînes de caractères (à l’aide de la méthode ToString() de l’objet), de sorte qu’elles sont représentées par le nom de la valeur de la propriété. Cette applet de commande n’exporte pas les méthodes de l’objet.