[PowerShell] 51. Out-String과 Out-Null

개요

Out-String과 Out-Null은 이름의 Out- 접두사가 같지만 정반대 목적을 가진 cmdlet이다. Out-String은 객체를 화면에 표시될 서식 그대로 문자열로 변환해 텍스트 도구에 넘기고, Out-Null은 결과를 화면에도, 파이프라인에도 남기지 않고 완전히 삭제한다. 10장에서 배운 객체 파이프라인 모델에서, 이 둘은 “객체 세계와 텍스트 세계의 경계"와 “출력이 필요 없을 때의 처리"를 각각 담당한다.

사용법

1
2

<객체> | Out-String [-Stream] [-Width <Int32>] [-NoNewline]
<명령> | Out-Null

매개변수

예시

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12

$text = Get-Culture | Select-Object -Property * | Out-String -Width 100   # 객체를 통째로 문자열 하나로

Get-Alias | Out-String -Stream | Select-String -Pattern "gcm"              # 줄 단위로 쪼개 grep처럼 검색
# -Stream 없이 Select-String에 넘기면 문자열 하나 전체에서만 찾아 원하는 결과가 안 나온다

@{ TestKey = ('x' * 200) } | Out-String                      # 기본 폭에서 잘림(...)
@{ TestKey = ('x' * 200) } | Out-String -Width 250             # 폭을 넓혀 잘림 방지

New-Item -Path C:\Temp\NewFolder -ItemType Directory | Out-Null   # 생성 결과 객체를 화면에 안 보이게
$null = New-Item -Path C:\Temp\Another -ItemType Directory         # 동일한 효과의 대안 문법

Get-Process | Out-Null                                        # 실행은 하되 출력은 완전히 버림

주의사항·함정

Out-String을 거치지 않고 텍스트 도구에 객체를 바로 넘기면 원하는 결과가 안 나온다: Get-Process | Select-String -Pattern "chrome"처럼 객체를 곧바로 Select-String에 넘기면, PowerShell이 각 객체를 문자열로 자동 변환하는 과정에서 서식이 예상과 다르게 적용돼 검색이 실패하기 쉽다. 46장에서 다룬 Select-String은 원래 텍스트·파일을 다루는 cmdlet이므로, 객체 결과를 검색하려면 먼저 Out-String -Stream으로 명시적으로 줄 단위 텍스트로 바꿔야 한다.

-Stream 없이는 여러 줄이 하나의 문자열로 뭉쳐져 줄 단위 처리가 안 된다: Out-String의 기본 동작은 전체 출력을 개행 문자가 포함된 문자열 하나로 반환하는 것이다. Select-String처럼 “줄마다” 처리하는 cmdlet과 연결하려면 반드시 -Stream을 붙여야 한다 — 빠뜨리면 오류는 나지 않지만 검색이 항상 “모두 일치” 또는 “전혀 일치 안 함"처럼 부자연스럽게 동작한다.

Out-Null과 $null = ...는 결과는 같지만 성능 특성이 다르다: 둘 다 출력을 없애는 데 쓰이지만, Out-Null은 파이프라인을 통해 객체를 흘려보내는 반면 $null = ...는 대입 연산만으로 처리되어 일반적으로 더 빠르다고 알려져 있다. 반복문 안에서 대량으로 출력을 억제해야 한다면 $null = ... 형태를 우선 고려할 만하다.

Out-Null로 버린 결과는 되돌릴 수 없다: New-Item ... | Out-Null처럼 생성 결과를 즉시 버리면, 그 객체(예: 새로 만든 파일의 경로 정보)를 나중에 다시 쓸 수 없다. 생성된 객체 자체가 필요할 가능성이 있다면 Out-Null 대신 변수에 담아 두는 편이 안전하다.

이식성: Out-Null은 Bash·CMD의 > /dev/null, > NUL 리다이렉션과 정확히 같은 역할을 한다. Out-String은 “객체를 텍스트로 강제 변환한다"는 개념 자체가 텍스트 기반 셸에는 없는 동작이다 — 애초에 모든 것이 이미 텍스트인 Bash·CMD에서는 이 변환이 불필요하기 때문이다.

Reference

• Out-String (Microsoft.PowerShell.Utility) - PowerShell | Microsoft Learn
• Out-Null (Microsoft.PowerShell.Core) - PowerShell | Microsoft Learn