개체를 연속 문자열로 호스트에 보냅니다.

구문

Out-String [-InputObject <psobject>] [-Stream] [-Width <int>] [<CommonParameters>]

설명

Out-String cmdlet은 Windows PowerShell이 관리하는 개체를 문자열 배열로 변환합니다. 기본적으로 Out-String은 문자열을 모아 단일 문자열로 반환하지만 Stream 매개 변수를 사용하면 Out-String으로 전달하여 한 번에 한 문자열을 반환할 수 있습니다. 이 cmdlet을 사용하면 개체를 편하게 조작할 수 없는 경우 기존 셸에서 하는 방법과 같이 문자열 출력을 검색하고 조작할 수 있습니다.

매개 변수

-InputObject <psobject>

문자열에 기록할 개체를 지정합니다. 개체가 포함된 변수를 입력하거나 개체를 가져오는 명령 또는 식을 입력하십시오.

필수 여부

false

위치

named

기본값

파이프라인 입력 적용 여부

true (ByValue)

와일드카드 문자 적용 여부

false

-Stream

각 개체의 문자열을 따로 보냅니다. 기본적으로 각 개체의 문자열은 단일 문자열로 모아서 보내집니다.

필수 여부

false

위치

named

기본값

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

-Width <int>

출력의 각 행에 포함되는 문자 수를 지정합니다. 이 문자보다 많으면 잘리거나 다음 줄로 넘어갑니다. 이 매개 변수를 생략하는 경우 호스트의 특징에 따라 너비가 결정됩니다. PowerShell.exe 호스트의 기본값은 80(자)입니다.

필수 여부

false

위치

named

기본값

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

<CommonParameters>

이 cmdlet은 -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, -OutVariable 등의 일반 매개 변수를 지원합니다. 자세한 내용은 about_Commonparameters.

입력 및 출력

입력 유형은 cmdlet으로 파이프할 수 있는 개체의 유형입니다. 반환 유형은 cmdlet에서 반환되는 개체의 유형입니다.

입력

System.Management.Automation.PSObject

개체를 Out-String으로 파이프할 수 있습니다.

출력

System.String

Out-String은 입력 개체에서 만드는 문자열을 반환합니다.

참고

Out 동사를 포함하는 cmdlet(Out cmdlet)은 개체의 형식을 지정하지 않고 렌더링만 한 후 지정된 표시 대상으로 보냅니다. 형식을 지정하지 않은 개체를 Out cmdlet에 보내면 이 cmdlet이 형식 지정 cmdlet으로 보낸 후 렌더링합니다.

Out cmdlet에는 이름이나 파일 경로에 대한 매개 변수가 없습니다. 데이터를 Out cmdlet으로 보내려면 파이프라인 연산자(|)를 사용하여 Windows PowerShell 명령의 출력을 cmdlet으로 보내십시오. 데이터를 변수에 저장하고 InputObject 매개 변수를 사용하여 cmdlet에 데이터를 전달할 수도 있습니다. 자세한 내용은 예를 참조하십시오.

예 1

C:\PS>get-content C:\test1\testfile2.txt | out-string

설명
-----------
이 명령은 Testfile2.txt 파일의 내용을 콘솔에 단일 문자열로 보냅니다. 이 명령은 Get-Content cmdlet을 사용하여 파일의 내용을 가져옵니다. 파이프라인 연산자(|)는 내용을 Out-String에 보내고 Out-String은 이 내용을 콘솔에 단일 문자열로 보냅니다.






예 2

C:\PS>$c = get-culture | select-object *

C:\PS> out-string -inputobject $c -width 100

설명
-----------
이들 명령은 현재 사용자에 대한 국가별 설정을 가져와 데이터를 문자열로 변환합니다. 첫 번째 명령은 Get-Culture cmdlet을 사용하여 국가별 설정을 가져옵니다. 파이프라인 연산자(|)는 Select-Object cmdlet로 결과를 보내고 Select-Object cmdlet은 Get-Culture가 검색한 culture 개체의 모든 속성(*)을 선택합니다. 그런 다음 이 명령은 $c 변수에 결과를 저장합니다.

두 번째 명령은 Out-String을 사용하여 CultureInfo 개체를 각 속성에 하나씩 일련의 문자열로 변환합니다. 이 명령은 InputObject 매개 변수를 사용하여 $c 변수를 Out-String으로 전달합니다. Width 매개 변수는 잘림을 방지하기 위해 줄당 100자로 설정됩니다.






예 3

C:\PS>get-alias | out-string -stream | select-string "Get-Command"

설명
-----------
이 명령은 "Get-Command"라는 구가 포함된 별칭을 표시합니다. 이 명령은 Get-Alias cmdlet을 사용하여 현재 세션의 각 별칭에 하나씩인 AliasInfo 개체 집합을 가져옵니다. 이 예에서는 개체를 사용하는 경우와 문자열을 사용하는 경우의 차이점을 보여 줍니다.

파이프라인 연산자(|)는 Out-String으로 Get-Alias 출력을 보내고 Out-String은 개체를 일련의 문자열로 변환합니다. 이 파이프라인 연산자는 각 문자열을 단일 문자열로 연결하는 대신 Stream 매개 변수를 사용하여 별도로 보냅니다. 다른 파이프라인 연산자는 Select-String으로 문자열을 보내고 Select-String은 문자열에 "Get-Command"가 포함된 문자열을 선택합니다. 

Select-String은 Out-String이 반환하는 단일 문자열에서 "Get-Command"를 찾기 때문에 Stream 매개 변수를 생략하는 경우 이 명령은 모든 별칭을 표시하며 포맷터는 문자열을 테이블로 표시합니다.






참고 항목




목차