[PowerShell] 37. Get-Content/Set-Content/Add-Content

개요

이 세 cmdlet은 파일(또는 다른 프로바이더 항목)의 내용을 읽고 쓰는 기본 도구다. Get-Content는 내용을 읽고, Set-Content는 기존 내용을 지우고 새로 쓰며, Add-Content는 기존 내용 뒤에 이어 붙인다. 세 cmdlet 모두 문자열 처리에 특화되어 있어, 객체를 그대로 저장하고 싶다면(19부에서 다룰) Export-Clixml이나 Out-File을 대신 검토해야 한다.

세 cmdlet의 역할 분담은 30장에서 다룬 프로바이더 개념과 그대로 이어진다 — Get-ChildItem이 어떤 프로바이더에서든 목록을 조회하는 창구였듯, 이 셋은 어떤 프로바이더에서든 “내용"이라는 개념을 다루는 공통 창구다. FileSystem 드라이브에서는 파일 텍스트가, Function: 드라이브에서는 함수 본문이 “내용"에 해당한다.

사용법

1
2
3

Get-Content [-Path] <String[]> [-Raw] [-Tail <Int32>] [-TotalCount <Int64>] [-Wait] [-Encoding <Encoding>]
Set-Content [-Path] <String[]> [-Value] <Object[]> [-NoNewline] [-Encoding <Encoding>]
Add-Content [-Path] <String[]> [-Value] <Object[]> [-NoNewline] [-Encoding <Encoding>]

매개변수

예시

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16

Get-Content -Path .\LineNumbers.txt                     # 줄 배열로 읽기
Get-Content -Path .\LineNumbers.txt -Raw                 # 하나의 문자열로(줄바꿈 보존)
Get-Content -Path .\LineNumbers.txt -Tail 1               # 마지막 줄만(빠름)
Get-Content -Path .\app.log -Wait -Tail 10                # tail -f처럼 실시간 확인

Set-Content -Path .\Test*.txt -Value 'Hello, World'        # 여러 파일 내용 한 번에 덮어쓰기
Add-Content -Path .\LineNumbers.txt -Value "This is line $_."   # 한 줄 추가

# 파일 내용을 가공해 같은 파일에 다시 쓰기
(Get-Content -Path .\Notice.txt) |
    ForEach-Object { $_ -replace 'Warning', 'Caution' } |
    Set-Content -Path .\Notice.txt

# 이진 파일을 바이트 배열로 읽고 그대로 쓰기
$bytes = Get-Content -Path C:\temp\test.bin -AsByteStream -Raw
Set-Content -Path C:\temp\copy.bin -Value $bytes -AsByteStream

주의사항·함정

기본 반환값은 배열이지, 하나의 문자열이 아니다: Get-Content는 줄마다 잘라 배열로 반환하므로, .Length나 .Contains() 같은 문자열 메서드를 파일 전체에 바로 적용하면 예상과 다르게 동작한다. 파일 전체를 하나의 문자열로 다루고 싶다면 반드시 -Raw를 붙여야 한다.

같은 파일을 읽으면서 동시에 쓸 수는 없다: Get-Content .\a.txt | Set-Content .\a.txt처럼 파일을 읽는 도중 같은 파일에 쓰려고 하면 오류가 나거나 내용이 손상될 수 있다. 파이프라인은 10장에서 봤듯 객체를 한 번에 하나씩 흘려보내는데, Set-Content가 파일을 열어 쓰기 시작하는 시점에 Get-Content가 아직 같은 파일을 읽는 중이면 두 작업이 충돌한다. 예시처럼 Get-Content를 괄호로 감싸 먼저 전체를 읽어들여 파이프라인을 완료시킨 뒤, 그 결과를 다시 Set-Content로 써야 안전하다.

Set-Content는 문자열 처리 전용이다: 문자열이 아닌 객체를 Set-Content에 넘기면 각 객체를 문자열로 변환(대개 기본 표시 형식)해 저장한다. 나중에 원래 객체로 정확히 복원해야 한다면 Set-Content 대신 Export-Clixml을 써야 한다.

인코딩 기본값 변화에 유의한다: PowerShell 6부터 -Encoding의 기본값이 utf8NoBOM으로 바뀌었다(Windows PowerShell 5.1은 지역별 기본 인코딩을 썼다). 같은 스크립트를 Windows PowerShell 5.1과 PowerShell 7 양쪽에서 돌려야 한다면, 파일을 쓰는 쪽과 읽는 쪽의 기본 인코딩이 서로 달라 한글 등 비ASCII 문자가 깨질 수 있다. 크로스플랫폼 스크립트나 다른 도구와 파일을 주고받을 때는 양쪽 모두 -Encoding을 명시하는 편이 안전하다.

이식성: CMD의 type(읽기)·리다이렉션(>/>>), Bash의 cat(읽기)·>/>>(쓰기/추가)에 각각 대응한다. Bash의 tail -f가 Get-Content -Wait -Tail과 정확히 같은 역할을 한다.

Reference

• Get-Content (Microsoft.PowerShell.Management) - PowerShell | Microsoft Learn
• Set-Content (Microsoft.PowerShell.Management) - PowerShell | Microsoft Learn
• Add-Content (Microsoft.PowerShell.Management) - PowerShell | Microsoft Learn