Поделиться через


Import-Csv

Создает такие табличные объекты из элементов в ФАЙЛЕ, разделенном символами (CSV).

Синтаксис

Import-Csv
      [[-Path] <string[]>]
      [[-Delimiter] <char>]
      [-LiteralPath <string[]>]
      [-Header <string[]>]
      [-Encoding <string>]
      [<CommonParameters>]
Import-Csv
      [[-Path] <string[]>]
      -UseCulture
      [-LiteralPath <string[]>]
      [-Header <string[]>]
      [-Encoding <string>]
      [<CommonParameters>]

Описание

Командлет Import-Csv создает такие настраиваемые объекты из элементов в CSV-файлах. Каждый столбец в файле CSV становится свойством настраиваемого объекта, а элементы в строках — значениями свойств. Import-Csv работает с любым CSV-файлом, включая файлы, созданные командлетом Export-Csv .

Параметры командлета можно использовать для указания строки заголовка Import-Csv столбца и разделителя элементов, а также для Import-Csv использования разделителя списка для текущего языка и региональных параметров в качестве разделителя элементов.

Можно также использовать ConvertTo-Csv командлеты и ConvertFrom-Csv командлеты для преобразования объектов в строки CSV (и обратно). Эти командлеты совпадают с Export-CSV командлетами и Import-Csv командлетами, за исключением того, что они не имеют дело с файлами.

Если запись строки заголовка в CSV-файле содержит пустое или пустое значение, PowerShell вставляет имя строки заголовка по умолчанию и отображает предупреждение.

Import-Csv использует метку байтового порядка (BOM) для обнаружения формата кодирования файла. Если файл не имеет BOM, предполагается, что кодировка — UTF8.

Примеры

Пример 1. Импорт объектов процесса

В этом примере показано, как экспортировать и импортировать CSV-файл объектов процесса.

Get-Process | Export-Csv -Path .\Processes.csv
$P = Import-Csv -Path .\Processes.csv
$P | Get-Member

TypeName: System.Management.Automation.PSCustomObject

Name                       MemberType   Definition
----                       ----------   ----------
Equals                     Method       bool Equals(System.Object obj)
GetHashCode                Method       int GetHashCode()
GetType                    Method       type GetType()
ToString                   Method       string ToString()
BasePriority               NoteProperty string BasePriority=8
Company                    NoteProperty string Company=Microsoft Corporation
...

$P | Format-Table

Name                   SI Handles VM            WS        PM        NPM    Path
----                   -- ------- --            --        --        ---    ----
ApplicationFrameHost   4  407     2199293489152 15884288  15151104  23792  C:\WINDOWS\system32\ApplicationFrameHost.exe
...
wininit                0  157     2199112204288 4591616   1630208   10376
winlogon               4  233     2199125549056 7659520   2826240   10992  C:\WINDOWS\System32\WinLogon.exe
WinStore.App           4  846     873435136     33652736  26607616  55432  C:\Program Files\WindowsApps\Microsoft.WindowsStore_11712.1001.13.0_x64__8weky...
WmiPrvSE               0  201     2199100219392 8830976   3297280   10632  C:\WINDOWS\system32\wbem\wmiprvse.exe
WmiPrvSE               0  407     2199157727232 18509824  12922880  16624  C:\WINDOWS\system32\wbem\wmiprvse.exe
WUDFHost               0  834     2199310204928 51945472  87441408  24984  C:\Windows\System32\WUDFHost.exe

Командлет Get-Process отправляет объекты обработки вниз конвейера Export-Csv. Командлет Export-Csv преобразует объекты процесса в строки CSV и сохраняет строки в файле Processes.csv. Командлет Import-Csv импортирует строки CSV из файла Processes.csv. Строки сохраняются в переменной $P . Переменная $P отправляется по конвейеру Get-Member командлету, который отображает свойства импортированных строк CSV. Переменная $P отправляется по конвейеру командлету Format-Table и отображает объекты.

Пример 2. Указание разделителя

В этом примере показано, как использовать параметр Разделителя командлета Import-Csv .

Get-Process | Export-Csv -Path .\Processes.csv -Delimiter :
$P = Import-Csv -Path .\Processes.csv -Delimiter :
$P | Format-Table

Командлет Get-Process отправляет объекты процесса вниз конвейера Export-Csv. Командлет Export-Csv преобразует объекты процесса в строки CSV и сохраняет строки в файле Processes.csv. Параметр разделителя используется для указания разделителя двоеточия. Командлет Import-Csv импортирует строки CSV из файла Processes.csv. Строки сохраняются в переменной $P . Переменная $P отправляется по конвейеру командлету Format-Table .

Пример 3. Указание текущего языка и региональных параметров для разделителя

В этом примере показано, как использовать командлет с параметром Import-CsvUseCulture .

(Get-Culture).TextInfo.ListSeparator
Get-Process | Export-Csv -Path .\Processes.csv -UseCulture
Import-Csv -Path .\Processes.csv -UseCulture

Командлет Get-Culture использует вложенные свойства TextInfo и ListSeparator для получения разделителя списка по умолчанию текущего языка и региональных параметров. Командлет Get-Process отправляет объекты процесса вниз конвейера Export-Csv. Командлет Export-Csv преобразует объекты процесса в строки CSV и сохраняет строки в файле Processes.csv. Параметр UseCulture использует разделитель списка по умолчанию текущего языка и региональных параметров. Командлет Import-Csv импортирует строки CSV из файла Processes.csv.

Пример 4. Изменение имен свойств в импортированном объекте

В этом примере показано, как использовать параметр ЗаголовкаImport-Csv для изменения имен свойств в результирующем импортированном объекте.

Start-Job -ScriptBlock { Get-Process } | Export-Csv -Path .\Jobs.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 file
$A = Get-Content -Path .\Jobs.csv
$A = $A[1..($A.Count - 1)]
$A | Out-File -FilePath .\Jobs.csv
$J = Import-Csv -Path .\Jobs.csv -Header $Header
$J

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]

Командлет запускает фоновое Start-Job задание, которое выполняется Get-Process. Объект задания отправляется по конвейеру Export-Csv командлету и преобразуется в строку CSV. Параметр NoTypeInformation удаляет заголовок сведений о типе из выходных данных CSV и необязателен в PowerShell версии 6 и выше. Переменная $Header содержит пользовательский заголовок, который заменяет следующие значения по умолчанию: HasMoreData, JobStateInfo, PSBeginTime, PSEndTime и PSJobTypeName. Переменная $A использует Get-Content командлет для получения строки CSV из файла Jobs.csv. Переменная $A используется для удаления заголовка по умолчанию из файла. Командлет Out-File сохраняет новую версию файла Jobs.csv в переменной $A . Командлет Import-Csv импортирует файл Jobs.csv и использует параметр Заголовка для применения переменной$Header. Переменная $J содержит импортированный PSCustomObject и отображает объект в консоли PowerShell.

Пример 5. Создание пользовательского объекта с помощью CSV-файла

В этом примере показано, как создать пользовательский объект в PowerShell с помощью CSV-файла.

Get-Content -Path .\Links.csv

113207,about_Aliases
113208,about_Arithmetic_Operators
113209,about_Arrays
113210,about_Assignment_Operators
113212,about_Automatic_Variables
113213,about_Break
113214,about_Command_Precedence
113215,about_Command_Syntax
144309,about_Comment_Based_Help
113216,about_CommonParameters
113217,about_Comparison_Operators
113218,about_Continue
113219,about_Core_Commands
113220,about_Data_Section

$A = Import-Csv -Path .\Links.csv -Header 'LinkID', 'TopicTitle'
$A | Get-Member

TypeName: System.Management.Automation.PSCustomObject

Name        MemberType   Definition
----        ----------   ----------
Equals      Method       bool Equals(System.Object obj)
GetHashCode Method       int GetHashCode()
GetType     Method       type GetType()
ToString    Method       string ToString()
LinkID      NoteProperty string LinkID=113207
TopicTitle  NoteProperty string TopicTitle=about_Aliases

$A | Where-Object -Property TopicTitle -Like '*alias*'

LinkID TopicTitle
------ ----------
113207 about_Aliases

Чтобы создать файл Links.csv, используйте значения, отображаемые в выходных Get-Content данных.

Командлет Get-Content отображает файл Links.csv. Командлет Import-Csv импортирует файл Links.csv. Параметр Header задает имена свойств LinkId и TopicTitle. Объекты хранятся в переменной $A . Командлет Get-Member отображает имена свойств из параметра Header . Командлет Where-Object выбирает объекты со свойством TopicTitle , которое включает псевдоним.

Пример 6. Импорт CSV-файла, который отсутствует значение

В этом примере показано, как Import-Csv командлет в PowerShell отвечает, когда строка заголовка в CSV-файле содержит значение NULL или пустое значение. Import-Csv заменяет имя по умолчанию для отсутствующих строк заголовков, которые становятся именем свойства возвращаемого объекта Import-Csv .

Get-Content -Path .\Projects.csv

ProjectID,ProjectName,,Completed
13,Inventory,Redmond,True
440,,FarEast,True
469,Marketing,Europe,False

Import-Csv -Path .\Projects.csv

WARNING: One or more headers were not specified. Default names starting with "H" have been used in
place of any missing headers.

ProjectID ProjectName H1      Completed
--------- ----------- --      ---------
13        Inventory   Redmond True
440                   FarEast True
469       Marketing   Europe  False

(Import-Csv -Path .\Projects.csv).H1

WARNING: One or more headers were not specified. Default names starting with "H" have been used in
place of any missing headers.
Redmond
FarEast
Europe

Чтобы создать файл Projects.csv, используйте значения, отображаемые в выходных данных примера Get-Content .

Командлет Get-Content отображает файл Projects.csv. Строка заголовка отсутствует между ProjectName и Completed. Командлет Import-Csv импортирует файл Projects.csv и отображает предупреждение, так как H1 — это имя заголовка по умолчанию. Команда (Import-Csv -Path .\Projects.csv).H1 получает значения свойств H1 и отображает предупреждение.

Параметры

-Delimiter

Задает разделитель для значений свойств в файле CSV. По умолчанию используется запятая (,).

Введите символ, например двоеточие (:). Чтобы указать точку с запятой (;), заключите ее в одинарные кавычки. Чтобы указать экранированные специальные символы, такие как tab (`t), заключите его в двойные кавычки.

Если в файле указан символ, отличный от фактического разделителя строк, Import-Csv не удается создать объекты из строк CSV и возвратит строки CSV.

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

-Encoding

Указывает тип кодировки для целевого файла. Значение по умолчанию — Default.

Допустимые значения для этого параметра приведены следующим образом:

  • ASCII Использует набор символов ASCII (7-разрядный).
  • BigEndianUnicode Использует UTF-16 с порядком байтов больших байтов.
  • Default Использует кодировку, соответствующую активной кодовой странице системы (обычно ANSI).
  • OEM Использует кодировку, соответствующую текущей кодовой странице OEM системы.
  • Unicode Использует UTF-16 с маленьким порядком байтов.
  • UTF7 Использует UTF-7.
  • UTF8 Использует UTF-8.
  • UTF32 Использует UTF-32 с маленьким порядком байтов.
Type:String
Accepted values:ASCII, BigEndianUnicode, Default, OEM, Unicode, UTF7, UTF8, UTF32
Position:Named
Default value:Default
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Header

Указывает альтернативную строку заголовков столбцов для импортируемого файла. Заголовок столбца определяет имена свойств объектов, созданных с помощью Import-Csv.

Введите заголовки столбцов в виде разделенного символами списка. Не заключайте в кавычки строку заголовка. Заключите каждый заголовок столбца в одинарные кавычки.

Если ввести меньше заголовков столбцов, чем есть столбцы данных, остальные столбцы данных будут отключены карта. Если ввести больше заголовков столбцов, чем есть столбцы данных, дополнительные заголовки столбцов создаются с пустыми столбцами данных.

При использовании параметра Header удалите исходную строку заголовков из файла CSV. Import-Csv В противном случае создает дополнительный объект из элементов в строке заголовка.

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

-LiteralPath

Указывает путь к импортируемому файлу CSV. В отличие от параметра Path, значение параметра LiteralPath используется в том виде, в котором оно введено. Никакие символы не интерпретируются как знаки подстановки. Если путь содержит escape-символы, заключите его в одинарные кавычки. Одинарные кавычки говорят PowerShell не интерпретировать какие-либо символы как escape-последовательности.

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

-Path

Указывает путь к импортируемому файлу CSV. Вы также можете передать путь к Import-Csv.

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

-UseCulture

Использует разделитель списка для текущего языка и региональных параметров в качестве разделителя элементов. Чтобы найти разделитель списка для языка и региональных параметров, используйте следующую команду: (Get-Culture).TextInfo.ListSeparator

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

Входные данные

String

В этот командлет можно передать по конвейеру строку, содержащую путь.

Выходные данные

Object

Этот командлет возвращает объекты, описанные содержимым в CSV-файле.

Примечания

Windows PowerShell включает следующие псевдонимы для Import-Csv:

  • ipcsv

Так как импортированные объекты являются csv-версиями типа объекта, они не распознаются и форматируются записями форматирования типов PowerShell, которые форматируют версии не CSV типа объекта.

Результатом Import-Csv команды является коллекция строк, формирующих пользовательский объект, например таблицу. Каждая строка является отдельной строкой, поэтому для подсчета строк таблицы можно использовать свойство Count объекта. Столбцы представляют свойства объекта, а поля строк — значения этих свойств.

Строка заголовков столбцов определяет число столбцов и их имена. Имена столбцов также являются именами свойств объектов. Первая строка интерпретируется как заголовки столбцов, если только не используется параметр заголовка для указания заголовков столбцов. Если в какой-либо строке содержится больше значений, чем в строке заголовков, лишние значения игнорируются.

Если строка заголовка столбца отсутствует или содержит значение NULL или пустое значение, Import-Csv использует H , за которым следует число для отсутствующего заголовка столбца и имени свойства.

В CSV-файле каждый объект представлен символьным списком значений свойств объекта. Значения свойств преобразуются в строки с помощью метода ToString() объекта, поэтому они представлены именем значения свойства. Export-Csv не экспортирует методы объекта.