ConvertTo-Csv
Преобразует объекты .NET в ряд строк, разделенных символами (CSV).
Синтаксис
Delimiter (По умолчанию)
ConvertTo-Csv
[-InputObject] <psobject>
[[-Delimiter] <char>]
[-NoTypeInformation]
[<CommonParameters>]
UseCulture
ConvertTo-Csv
[-InputObject] <psobject>
[-UseCulture]
[-NoTypeInformation]
[<CommonParameters>]
Описание
Командлет ConvertTo-Csv возвращает ряд строк, разделенных символами (CSV), представляющих объекты, которые вы отправляете. Затем можно использовать командлет ConvertFrom-Csv для повторного создания объектов из строк CSV. Объекты, преобразованные из CSV, являются строковыми значениями исходных объектов, содержащих значения свойств, и никакие методы.
С помощью командлета Export-Csv можно преобразовать объекты в строки CSV.
Export-Csv аналогичен ConvertTo-Csv, за исключением того, что он сохраняет строки CSV в файл.
Командлет ConvertTo-Csv имеет параметры, чтобы указать разделитель, отличный от запятой, или использовать текущий язык и региональные параметры в качестве разделителя.
Примеры
Пример 1. Преобразование объекта в CSV
В этом примере объект процесса преобразуется в строку CSV.
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", ...
Командлет Get-Process получает объект процесса и использует параметр имени для указания процесса PowerShell. Объект процесса отправляется в конвейер в командлет ConvertTo-Csv. Командлет ConvertTo-Csv преобразует объект в строки CSV. Параметр NoTypeInformation удаляет заголовок сведений #TYPE из выходных данных CSV.
Пример 2. Преобразование объекта DateTime в CSV
В этом примере объект dateTime преобразуется в строку CSV.
$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"
Командлет Get-Date получает объект DateTime и сохраняет его в переменной $Date. Командлет ConvertTo-Csv преобразует объект DateTime в строки. Параметр InputObject использует объект DateTime, хранящийся в переменной $Date. Параметр разделителя указывает точку с запятой для разделения строковых значений. Параметр NoTypeInformation удаляет заголовок сведений #TYPE из выходных данных CSV.
Пример 3. Преобразование журнала событий PowerShell в CSV
В этом примере журнал событий Windows для PowerShell преобразуется в ряд строк CSV.
(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", ...
Командлет Get-Culture использует вложенные свойства TextInfo и ListSeparator и отображает разделитель списка по умолчанию текущего языка и региональных параметров. Командлет Get-WinEvent получает объекты журнала событий и использует параметр LogName для указания имени файла журнала. Объекты журнала событий отправляются по конвейеру командлету ConvertTo-Csv. Командлет ConvertTo-Csv преобразует объекты журнала событий в ряд строк CSV. Параметр UseCulture использует разделитель списка по умолчанию текущего языка и региональных параметров в качестве разделителя. Параметр NoTypeInformation удаляет заголовок сведений #TYPE из выходных данных CSV.
Параметры
-Delimiter
Указывает разделитель для разделения значений свойств в строках CSV. По умолчанию используется запятая (,).
Введите символ, например двоеточие (:). Чтобы указать точку с запятой (;), заключите ее в одинарные кавычки. Чтобы указать экранированные специальные символы, такие как tab (`t), заключите его в двойные кавычки.
Свойства параметров
| Тип: | Char |
| Default value: | comma (,) |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
Delimiter
| Position: | 1 |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-InputObject
Указывает объекты, преобразованные в строки CSV. Введите переменную, содержащую объекты или введите команду или выражение, которое получает объекты. Также можно передать объекты в ConvertTo-Csv.
Свойства параметров
| Тип: | PSObject |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | 0 |
| Обязательно: | True |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-NoTypeInformation
Удаляет заголовок сведений #TYPE из выходных данных. Этот параметр стал значением по умолчанию в PowerShell 6.0 и включен для обратной совместимости.
Свойства параметров
| Тип: | SwitchParameter |
| Default value: | False |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | NTI |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-UseCulture
Использует разделитель списка для текущей культуры в качестве делимитера элементов. Чтобы найти разделитель списка для культуры, используйте следующую команду: (Get-Culture).TextInfo.ListSeparator.
Свойства параметров
| Тип: | SwitchParameter |
| Default value: | False |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
UseCulture
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
CommonParameters
Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.
Входные данные
PSObject
Вы можете передать любой объект с адаптером расширенной системы типов (ETS) в этот командлет.
Выходные данные
String
Этот командлет возвращает одну или несколько строк, представляющих каждый преобразованный объект.
Примечания
В формате CSV каждый объект представлен символьным списком его значения свойства. Значения свойств преобразуются в строки с помощью метода ToString() объекта. Строки представлены именем значения свойства.
ConvertTo-Csv не экспортирует методы объекта.
Строки CSV выводятся следующим образом:
- По умолчанию первая строка содержит заголовок #TYPE сведений, за которым следует полное имя типа объекта. Например, #TYPE System.Diagnostics.Process.
- Если NoTypeInformation используется первая строка содержит заголовки столбцов. Заголовки содержат имена свойств первого объекта в виде разделенного запятыми списка.
- Остальные строки содержат разделенные запятыми списки значений свойств каждого объекта.
При отправке нескольких объектов в ConvertTo-CsvConvertTo-Csv упорядочивает строки на основе свойств первого объекта, который вы отправляете. Если остальные объекты не имеют одного из указанных свойств, значение свойства этого объекта равно NULL, как представлено двумя последовательными запятыми. Если оставшиеся объекты имеют дополнительные свойства, эти значения свойств игнорируются.
