다음을 통해 공유

Out-String

  • 참조
모듈:
Microsoft.PowerShell.Utility

일련의 문자열로 호스트에 개체를 보냅니다.

구문

Out-String
   [-Stream]
   [-Width <Int32>]
   [-InputObject <PSObject>]
   [<CommonParameters>]

Description

Out-String cmdlet은 Windows PowerShell에서 관리하는 개체를 문자열 배열로 변환합니다. 기본적으로 Out-String 문자열을 누적하고 단일 문자열로 반환하지만 Stream 매개 변수를 사용하여 Out-String 한 번에 하나의 문자열을 반환하도록 지시할 수 있습니다. 이 cmdlet을 사용하면 개체 조작이 덜 편리할 때 기존 셸에서와 마찬가지로 문자열 출력을 검색하고 조작할 수 있습니다.

예제

예제 1: 콘솔에 문자열로 텍스트 출력

PS C:\> Get-Content C:\test1\testfile2.txt | Out-String

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

예제 2: 현재 문화권을 가져와서 데이터를 문자열로 변환

첫 번째 명령은 Get-Culture cmdlet을 사용하여 지역 설정을 가져옵니다. 파이프라인 연산자(|)는 반환된 문화권 Get-Culture 개체의 모든 속성(*)을 선택하는 Select-Object cmdlet에 결과를 보냅니다. 그런 다음 이 명령은 결과를 $C 변수에 저장합니다.

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

PS C:\> $C = Get-Culture | Select-Object *
PS C:\> Out-String -InputObject $C -Width 100

이러한 명령은 현재 사용자의 국가별 설정을 가져와 데이터를 문자열로 변환합니다.

예제 3: 개체 작업

PS C:\> Get-Alias | Out-String -Stream | Select-String "Get-Command"

이 예제에서는 개체 작업과 문자열 작업 간의 차이점을 보여 줍니다. 이 명령은 "Get-Command"라는 구를 포함하는 별칭을 표시합니다. Get-Alias cmdlet을 사용하여 AliasInfo 개체 집합을 가져옵니다(현재 세션의 각 별칭에 대해 하나씩).

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

Stream 매개 변수를 생략하면 Select-StringOut-String 반환하는 단일 문자열에서 "Get-Command"를 찾고 포맷터는 문자열을 테이블로 표시하기 때문에 모든 별칭이 표시됩니다.

매개 변수

-InputObject

문자열에 쓸 개체를 지정합니다. 개체가 포함된 변수를 입력하거나 개체를 가져오는 명령이나 식을 입력합니다.

형식:PSObject
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-Stream

cmdlet이 각 개체에 대한 문자열을 개별적으로 보내도록 나타냅니다. 기본적으로 각 개체의 문자열은 누적되어 단일 문자열로 전송됩니다.

Stream 매개 변수를 사용하려면 -Stream 또는 해당 별칭을 ost.

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Width

각 출력 줄의 문자 수를 지정합니다. 추가 문자는 래핑되지 않고 잘립니다. Width 매개 변수는 서식이 지정된 개체에만 적용됩니다. 이 매개 변수를 생략하면 너비는 호스트 프로그램의 특성에 따라 결정됩니다. Windows PowerShell 콘솔의 기본값은 80자입니다.

형식:Int32
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

입력

PSObject

개체를 파이프하여 Out-String수 있습니다.

출력

String

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

참고

  • 개체의 서식을 지정하지 않는 Out 동사가 포함된 cmdlet입니다. 단지 렌더링하고 지정된 표시 대상으로 보냅니다. 형식이 지정되지 않은 개체를 Out cmdlet에 보내는 경우 cmdlet은 렌더링하기 전에 서식 cmdlet으로 보냅니다.
  • Out cmdlet에는 이름 또는 파일 경로를 사용하는 매개 변수가 없습니다. Out cmdlet으로 데이터를 보내려면 파이프라인 연산자(|)를 사용하여 Windows PowerShell 명령의 출력을 cmdlet으로 보냅니다. 변수에 데이터를 저장하고 InputObject 매개 변수를 사용하여 데이터를 cmdlet에 전달할 수도 있습니다.