Import-Csv
Создает такие табличные объекты из элементов в ФАЙЛЕ, разделенном символами (CSV).
Синтаксис
Import-Csv
[[-Delimiter] <Char>]
[-Path] <String[]>
[-Header <String[]>]
[-Encoding <Encoding>]
[<CommonParameters>]Import-Csv
[[-Delimiter] <Char>]
-LiteralPath <String[]>
[-Header <String[]>]
[-Encoding <Encoding>]
[<CommonParameters>]Import-Csv
[-Path] <String[]>
-UseCulture
[-Header <String[]>]
[-Encoding <Encoding>]
[<CommonParameters>]Import-Csv
-LiteralPath <String[]>
-UseCulture
[-Header <String[]>]
[-Encoding <Encoding>]
[<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 вставляет имя строки заголовка по умолчанию и отображает предупреждение.
Начиная с PowerShell 6.0 теперь Import-Csv поддерживает формат расширенного файла журнала W3C.
Примеры
Пример 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
Задает кодировку импортированного CSV-файла. Значение по умолчанию — utf8NoBOM.
Допустимые значения для этого параметра приведены следующим образом:
ascii: использует кодировку для набора символов ASCII (7-разрядная версия).bigendianunicode: кодирует в формате UTF-16 с помощью порядка байтов больших байтов.bigendianutf32: кодирует в формате UTF-32 с помощью порядка байтов больших байтов.oem: использует кодировку по умолчанию для программ MS-DOS и консольных программ.unicode: кодирует в формате UTF-16 с помощью байтового порядка байтов.utf7: кодирует в формате UTF-7.utf8: кодирует в формате UTF-8.utf8BOM: кодирует в формате UTF-8 с меткой порядка байтов (BOM)utf8NoBOM: кодирует в формате UTF-8 без метки порядка байтов (BOM)utf32: кодирует в формате UTF-32.
Начиная с PowerShell 6.2, параметр кодирования также позволяет числовым идентификаторам зарегистрированных кодовых страниц (например) или строковым именам зарегистрированных кодовых страниц (например-Encoding "windows-1251"-Encoding 1251). Дополнительные сведения см. в документации по .NET для Encoding.CodePage.
Примечание.
UTF-7* больше не рекомендуется использовать. По состоянию на PowerShell 7.1 предупреждение записывается при указании utf7 параметра кодирования .
| Type: | Encoding |
| Accepted values: | ASCII, BigEndianUnicode, BigEndianUTF32, OEM, Unicode, UTF7, UTF8, UTF8BOM, UTF8NoBOM, UTF32 |
| Position: | Named |
| Default value: | UTF8NoBOM |
| 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, LP |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Path
Указывает путь к импортируемому файлу CSV.
Вы также можете передать путь к Import-Csv.
| Type: | String[] |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| 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 |
Входные данные
В этот командлет можно передать по конвейеру строку, содержащую путь.
Выходные данные
Этот командлет возвращает объекты, описанные содержимым в CSV-файле.
Примечания
PowerShell включает следующие псевдонимы для Import-Csv:
- Все платформы:
ipcsv
Так как импортированные объекты являются csv-версиями типа объекта, они не распознаются и форматируются записями форматирования типов PowerShell, которые форматируют версии не CSV типа объекта.
Результатом Import-Csv команды является коллекция строк, формирующих пользовательский объект, например таблицу. Каждая строка является отдельной строкой, поэтому для подсчета строк таблицы можно использовать свойство Count объекта. Столбцы представляют свойства объекта, а поля строк — значения этих свойств.
Строка заголовков столбцов определяет число столбцов и их имена. Имена столбцов также являются именами свойств объектов. Первая строка интерпретируется как заголовки столбцов, если только не используется параметр заголовка для указания заголовков столбцов. Если в какой-либо строке содержится больше значений, чем в строке заголовков, лишние значения игнорируются.
Если строка заголовка столбца отсутствует или содержит значение NULL или пустое значение, Import-Csv использует H , за которым следует число для отсутствующего заголовка столбца и имени свойства.
В CSV-файле каждый объект представлен символьным списком значений свойств объекта. Значения свойств преобразуются в строки с помощью метода ToString() объекта, поэтому они представлены именем значения свойства. Export-Csv не экспортирует методы объекта.
Import-Csv также поддерживает формат расширенного журнала W3C. Строки, начинаемые с # , рассматриваются как комментарии и игнорируются, если комментарий не начинается с #Fields: и содержит список имен столбцов с разделителями. В этом случае командлет использует эти имена столбцов. Это стандартный формат для служб IIS Windows и других журналов веб-сервера. Дополнительные сведения см. в разделе "Расширенный формат файла журнала".
Связанные ссылки
PowerShell
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по