Get-Content

구문

Get-Content
   [-Path] <string[]>
   [-ReadCount <long>]
   [-TotalCount <long>]
   [-Tail <int>]
   [-Filter <string>]
   [-Include <string[]>]
   [-Exclude <string[]>]
   [-Force]
   [-Credential <pscredential>]
   [-UseTransaction]
   [-Delimiter <string>]
   [-Wait]
   [-Raw]
   [-Encoding <FileSystemCmdletProviderEncoding>]
   [-Stream <string>]
   [<CommonParameters>]

Get-Content
   -LiteralPath <string[]>
   [-ReadCount <long>]
   [-TotalCount <long>]
   [-Tail <int>]
   [-Filter <string>]
   [-Include <string[]>]
   [-Exclude <string[]>]
   [-Force]
   [-Credential <pscredential>]
   [-UseTransaction]
   [-Delimiter <string>]
   [-Wait]
   [-Raw]
   [-Encoding <FileSystemCmdletProviderEncoding>]
   [-Stream <string>]
   [<CommonParameters>]

Description

Get-Content cmdlet은 파일의 텍스트 또는 함수 내용과 같이 경로에 지정된 위치에 있는 항목의 콘텐츠를 가져옵니다. 파일의 경우 콘텐츠는 한 번에 한 줄씩 읽고 개체 컬렉션을 반환하며, 각각은 콘텐츠 줄을 나타냅니다.

PowerShell 3.0부터 Get-Content 항목의 시작 또는 끝에서 지정된 줄 수를 가져올 수도 있습니다.

예제

예제 1: 텍스트 파일의 콘텐츠 가져오기

이 예제에서는 현재 디렉터리에 있는 파일의 콘텐츠를 가져옵니다. LineNumbers.txt 파일에는 100줄 형식이 X줄 여러 예제에서 사용됩니다.

1..100 | ForEach-Object { Add-Content -Path .\LineNumbers.txt -Value "This is line $_." }
Get-Content -Path .\LineNumbers.txt

This is Line 1
This is Line 2
...
This is line 99.
This is line 100.

배열 값 1-100은 파이프라인을 ForEach-Object cmdlet으로 보냅니다. ForEach-Object Add-Content cmdlet과 함께 스크립트 블록을 사용하여 LineNumbers.txt 파일을 만듭니다. $_ 변수는 각 개체가 파이프라인 아래로 전송됨에 따라 배열 값을 나타냅니다. Get-Content cmdlet은 Path 매개 변수를 사용하여 LineNumbers.txt 파일을 지정하고 PowerShell 콘솔에 콘텐츠를 표시합니다.

예제 2: 반환할 줄 수 Get-Content 제한

이 명령은 파일의 처음 5줄을 가져옵니다. TotalCount 매개 변수는 처음 5줄의 콘텐츠를 가져오는 데 사용됩니다. 이 예제에서는 예제 1에서 만든 LineNumbers.txt 파일을 사용합니다.

Get-Content -Path .\LineNumbers.txt -TotalCount 5

This is Line 1
This is Line 2
This is Line 3
This is Line 4
This is Line 5

예제 3: 텍스트 파일에서 특정 콘텐츠 줄 가져오기

이 명령은 파일에서 특정 줄 수를 가져오고 해당 콘텐츠의 마지막 줄만 표시합니다. TotalCount 매개 변수는 처음 25줄의 콘텐츠를 가져옵니다. 이 예제에서는 예제 1에서 만든 LineNumbers.txt 파일을 사용합니다.

(Get-Content -Path .\LineNumbers.txt -TotalCount 25)[-1]

This is Line 25

Get-Content 명령은 다음 단계로 넘어가기 전에 명령이 완료되도록 괄호로 래핑됩니다. Get-Content줄 배열을 반환하므로 괄호 뒤의 인덱스 표기법을 추가하여 특정 줄 번호를 검색할 수 있습니다. 이 경우 [-1] 인덱스는 검색된 25개 줄의 반환된 배열에서 마지막 인덱스를 지정합니다.

예제 4: 텍스트 파일의 마지막 줄 가져오기

이 명령은 파일에서 콘텐츠의 첫 번째 줄과 마지막 줄을 가져옵니다. 이 예제에서는 예제 1에서 만든 LineNumbers.txt 파일을 사용합니다.

Get-Item -Path .\LineNumbers.txt | Get-Content -Tail 1

This is Line 100

이 예제에서는 Get-Item cmdlet을 사용하여 파일을 Get-Content 매개 변수로 파이프할 수 있음을 보여 줍니다. Tail 매개 변수는 파일의 마지막 줄을 가져옵니다. 이 메서드는 모든 줄을 검색하고 [-1] 인덱스 표기법을 사용하는 것보다 빠릅니다.

예제 5: 대체 데이터 스트림의 콘텐츠 가져오기

이 예제에서는 Stream 매개 변수를 사용하여 Windows NTFS 볼륨에 저장된 파일에 대한 대체 데이터 스트림의 콘텐츠를 가져오는 방법을 설명합니다. 이 예제에서는 Set-Content cmdlet을 사용하여 Stream.txt파일에 샘플 콘텐츠를 만듭니다.

Set-Content -Path .\Stream.txt -Value 'This is the content of the Stream.txt file'
# Specify a wildcard to the Stream parameter to display all streams of the recently created file.
Get-Item -Path .\Stream.txt -Stream *

PSPath        : Microsoft.PowerShell.Core\FileSystem::C:\Test\Stream.txt::$DATA
PSParentPath  : Microsoft.PowerShell.Core\FileSystem::C:\Test
PSChildName   : Stream.txt::$DATA
PSDrive       : C
PSProvider    : Microsoft.PowerShell.Core\FileSystem
PSIsContainer : False
FileName      : C:\Test\Stream.txt
Stream        : :$DATA
Length        : 44

# Retrieve the content of the primary, or $DATA stream.
Get-Content -Path .\Stream.txt -Stream $DATA

This is the content of the Stream.txt file

# Use the Stream parameter of Add-Content to create a new Stream containing sample content.
Add-Content -Path .\Stream.txt -Stream NewStream -Value 'Added a stream named NewStream to Stream.txt'
# Use Get-Item to verify the stream was created.
Get-Item -Path .\Stream.txt -Stream *

PSPath        : Microsoft.PowerShell.Core\FileSystem::C:\Test\Stream.txt::$DATA
PSParentPath  : Microsoft.PowerShell.Core\FileSystem::C:\Test
PSChildName   : Stream.txt::$DATA
PSDrive       : C
PSProvider    : Microsoft.PowerShell.Core\FileSystem
PSIsContainer : False
FileName      : C:\Test\Stream.txt
Stream        : :$DATA
Length        : 44

PSPath        : Microsoft.PowerShell.Core\FileSystem::C:\Test\Stream.txt:NewStream
PSParentPath  : Microsoft.PowerShell.Core\FileSystem::C:\Test
PSChildName   : Stream.txt:NewStream
PSDrive       : C
PSProvider    : Microsoft.PowerShell.Core\FileSystem
PSIsContainer : False
FileName      : C:\Test\Stream.txt
Stream        : NewStream
Length        : 46

# Retrieve the content of your newly created Stream.
Get-Content -Path .\Stream.txt -Stream NewStream

Added a stream named NewStream to Stream.txt

Stream 매개 변수는 FileSystem 공급자동적 매개 변수입니다. 기본적으로 Get-Content 기본 또는 $DATA 스트림에서만 데이터를 검색합니다. Streams 사용하여 특성, 보안 설정 또는 기타 데이터와 같은 숨겨진 데이터를 저장할 수 있습니다.

예제 6: 원시 콘텐츠 가져오기

이 예제의 명령은 파일의 내용을 문자열 배열 대신 하나의 문자열로 가져옵니다. 기본적으로 Raw 동적 매개 변수가 없으면 콘텐츠가 줄 바꿈으로 구분된 문자열의 배열로 반환됩니다. 이 예제에서는 예제 1에서 만든 LineNumbers.txt 파일을 사용합니다.

$raw = Get-Content -Path .\LineNumbers.txt -Raw
$lines = Get-Content -Path .\LineNumbers.txt
Write-Host "Raw contains $($raw.Count) lines."
Write-Host "Lines contains $($lines.Count) lines."

Raw contains 1 lines.
Lines contains 100 lines.

예제 7: Get-Content 필터 사용

Get-Content cmdlet에 필터를 지정할 수 있습니다. 필터를 사용하여 Path 매개 변수를 한정하는 경우 경로의 내용을 나타내기 위해 후행 별표(*)를 포함해야 합니다.

다음 명령은 C:\Temp 디렉터리에 있는 모든 *.log 파일의 콘텐츠를 가져옵니다.

Get-Content -Path C:\Temp\* -Filter *.log

예제 8: 파일 내용을 바이트 배열로 가져오기

이 예제에서는 파일의 내용을 단일 개체로 [byte[]] 가져오는 방법을 보여 줍니다.

$byteArray = Get-Content -Path C:\temp\test.txt -Encoding Byte -Raw
Get-Member -InputObject $bytearray

TypeName: System.Byte[]

Name           MemberType            Definition
----           ----------            ----------
Count          AliasProperty         Count = Length
Add            Method                int IList.Add(System.Object value)

첫 번째 명령은 인코딩 매개 변수를 사용하여 파일에서 바이트 스트림을 가져옵니다. Raw 매개 변수는 바이트가 [System.Byte[]]반환되도록 합니다. Raw 매개 변수가 없는 경우 반환 값은 powerShell에서 [System.Object[]]해석되는 바이트 스트림입니다.

매개 변수

-Credential

-Delimiter

-Encoding

-Exclude

-Filter

-Force

-Include

-LiteralPath

-Path

-Raw

-ReadCount

-Stream

-Tail

-TotalCount

-UseTransaction

-Wait

입력

System.Int64, System.String[], System.Management.Automation.PSCredential

읽기 수, 총 개수, 경로 또는 자격 증명을 파이프하여 Get-Content수 있습니다.

출력

System.Byte, System.String

Get-Content 문자열 또는 바이트를 반환합니다. 출력 형식은 입력으로 지정하는 콘텐츠 형식에 따라 달라집니다.

참고

Get-Content cmdlet은 모든 공급자가 노출하는 데이터를 사용하도록 설계되었습니다. 세션에서 공급자를 얻으려면 Get-PSProvider cmdlet을 사용합니다. 자세한 내용은 about_Providers참조하세요.

관련 링크

• about_Automatic_Variables
• about_Providers
• Add-Content
• Clear-Content
• ForEach-Object
• Get-PSProvider
• Set-Content