다음을 통해 공유

ConvertTo-Csv

  • 참조
모듈:
Microsoft.PowerShell.Utility

.NET 개체를 일련의 CSV(문자로 구분된 값) 문자열로 변환합니다.

Syntax

ConvertTo-Csv
              [-InputObject] <psobject>
              [[-Delimiter] <char>]
              [-NoTypeInformation]
              [<CommonParameters>]
ConvertTo-Csv
              [-InputObject] <psobject>
              [-UseCulture]
              [-NoTypeInformation]
              [<CommonParameters>]

Description

이 cmdlet은 ConvertTo-CSV 제출하는 개체를 나타내는 일련의 CSV(문자 구분 값) 문자열을 반환합니다. 그런 다음 cmdlet을 ConvertFrom-Csv 사용하여 CSV 문자열에서 개체를 다시 만들 수 있습니다. CSV에서 변환된 개체는 속성 값과 메서드가 없는 원래 개체의 문자열 값입니다.

cmdlet을 Export-Csv 사용하여 개체를 CSV 문자열로 변환할 수 있습니다. Export-CSV 은 CSV 문자열을 파일에 저장한다는 점을 제외하고 유사 ConvertTo-CSV합니다.

cmdlet에는 ConvertTo-CSV 쉼표 이외의 구분 기호를 지정하거나 현재 문화권을 구분 기호로 사용하는 매개 변수가 있습니다.

예제

예제 1: 개체를 CSV로 변환

다음은 Process 개체를 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", ...

cmdlet은 Get-Process Process 개체를 가져오고 Name 매개 변수를 사용하여 PowerShell 프로세스를 지정합니다. 프로세스 개체는 파이프라인을 cmdlet으로 ConvertTo-CSV 보냅니다. cmdlet은 ConvertTo-CSV 개체를 CSV 문자열로 변환합니다. NoTypeInformation 매개 변수는 CSV 출력에서 #TYPE 정보 헤더를 제거합니다.

예제 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"

cmdlet은 Get-Date DateTime 개체를 가져오고 변수에 $Date 저장합니다. cmdlet은 ConvertTo-Csv DateTime 개체를 문자열로 변환합니다. InputObject 매개 변수는 변수에 저장된 DateTime 개체를 $Date 사용합니다. 구분 기호 매개 변수는 문자열 값을 구분하는 세미콜론을 지정합니다. NoTypeInformation 매개 변수는 CSV 출력에서 #TYPE 정보 헤더를 제거합니다.

예제 3: PowerShell 이벤트 로그를 CSV로 변환

다음은 PowerShell에 대한 Windows 이벤트 로그를 일련의 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", ...

cmdlet은 Get-Culture TextInfo 및 ListSeparator 중첩 속성을 사용하고 현재 문화권의 기본 목록 구분 기호를 표시합니다. cmdlet은 Get-WinEvent 이벤트 로그 개체를 가져오고 LogName 매개 변수를 사용하여 로그 파일 이름을 지정합니다. 이벤트 로그 개체는 파이프라인을 cmdlet으로 ConvertTo-Csv 보냅니다. cmdlet은 ConvertTo-Csv 이벤트 로그 개체를 일련의 CSV 문자열로 변환합니다. UseCulture 매개 변수는 현재 문화권의 기본 목록 구분 기호를 구분 기호로 사용합니다. NoTypeInformation 매개 변수는 CSV 출력에서 #TYPE 정보 헤더를 제거합니다.

매개 변수

-Delimiter

CSV 문자열에서 속성 값을 구분할 구분 기호를 지정합니다. 기본값은 쉼표(,)입니다. 콜론(:)과 같은 문자를 입력합니다. 세미콜론(;)을 지정하려면 작은따옴표로 묶습니다.

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

-InputObject

CSV 문자열로 변환되는 개체를 지정합니다. 개체를 포함하는 변수를 입력하거나 개체를 가져오는 명령이나 식을 입력합니다. 개체를 으로 파이프할 ConvertTo-CSV수도 있습니다.

Type:PSObject
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-NoTypeInformation

출력에서 #TYPE 정보 헤더를 제거합니다. 이 매개 변수는 PowerShell 6.0의 기본값이 되었으며 이전 버전과의 호환성을 위해 포함됩니다.

Type:SwitchParameter
Aliases:NTI
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UseCulture

현재 문화권의 목록 구분 기호를 항목 구분 기호로 사용합니다. 문화권의 목록 구분 기호를 찾으려면 다음 명령을 (Get-Culture).TextInfo.ListSeparator사용합니다.

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

입력

PSObject

ETS(확장 형식 시스템) 어댑터가 있는 모든 개체를 이 cmdlet으로 파이프할 수 있습니다.

출력

String

이 cmdlet은 변환된 각 개체를 나타내는 하나 이상의 문자열을 반환합니다.

참고

CSV 형식에서 각 개체는 속성 값의 문자로 구분된 목록으로 표시됩니다. 속성 값은 개체의 ToString() 메서드를 사용하여 문자열로 변환됩니다. 문자열은 속성 값 이름으로 표시됩니다. ConvertTo-CSV 는 개체의 메서드를 내보내지 않습니다.

CSV 문자열은 다음과 같이 출력됩니다.

  • 기본적으로 첫 번째 문자열에는 개체 형식의 정규화된 이름 뒤에 #TYPE 정보 헤더가 포함됩니다. 예를 들어 system.Diagnostics.Process를 #TYPE.
  • NoTypeInformation을 사용하는 경우 첫 번째 문자열에는 열 머리글이 포함됩니다. 헤더에는 첫 번째 개체의 속성 이름이 쉼표로 구분된 목록으로 포함됩니다.
  • 다시 기본 문자열에는 각 개체의 속성 값에 대한 쉼표로 구분된 목록이 포함됩니다.

여러 개체를 ConvertTo-CSVConvertTo-CSV 제출할 때 제출하는 첫 번째 개체의 속성에 따라 문자열을 정렬합니다. re기본ing 개체에 지정된 속성 중 하나가 없는 경우 해당 개체의 속성 값은 두 개의 연속된 쉼표로 표시되는 Null입니다. 나머지 개체에 추가 속성이 있으면 해당 속성 값은 무시됩니다.