다음을 통해 공유


Out-String

입력 개체를 문자열로 출력합니다.

구문

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

Description

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

또한 PowerShell은 파이프라인에서 OSS 사용할 Out-String 약식 방법으로 호출 Out-String -Stream 하는 함수를 추가합니다.

예제

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

다음은 현재 사용자의 국가별 설정을 가져오고 개체 데이터를 문자열로 변환하는 예제입니다.

$C = Get-Culture | Select-Object -Property *
Out-String -InputObject $C -Width 100

Parent                         : en
LCID                           : 1033
KeyboardLayoutId               : 1033
Name                           : en-US
IetfLanguageTag                : en-US
DisplayName                    : English (United States)
NativeName                     : English (United States)
EnglishName                    : English (United States)
TwoLetterISOLanguageName       : en
ThreeLetterISOLanguageName     : eng
ThreeLetterWindowsLanguageName : ENU
CompareInfo                    : CompareInfo - en-US
TextInfo                       : TextInfo - en-US
IsNeutralCulture               : False
CultureTypes                   : SpecificCultures, InstalledWin32Cultures, FrameworkCultures
NumberFormat                   : System.Globalization.NumberFormatInfo
DateTimeFormat                 : System.Globalization.DateTimeFormatInfo
Calendar                       : System.Globalization.GregorianCalendar
OptionalCalendars              : {System.Globalization.GregorianCalendar,
                                 System.Globalization.GregorianCalendar}
UseUserOverride                : True
IsReadOnly                     : False

변수는 $C Selected.System.Globalization.CultureInfo 개체를 저장합니다. 개체는 파이프라인에서 Get-Culture 출력을 로 Select-Object보낸 결과입니다. Property 매개 변수는 별표(*) 와일드카드를 사용하여 개체에 포함된 모든 속성을 지정합니다.

Out-String 에서는 InputObject 매개 변수를 사용하여 변수에 저장된 CultureInfo 개체를 $C 지정합니다. 개체 $C 가 문자열로 변환됩니다.

참고 항목

배열을 Out-String 보려면 출력을 변수에 저장하고 배열 인덱스로 요소를 봅니다. 배열 인덱스에 대한 자세한 내용은 about_Arrays 참조하세요.

$str = Out-String -InputObject $C -Width 100

예제 2: 개체 작업

이 예제에서는 개체 작업과 문자열 작업 간의 차이점을 보여 줍니다. 이 명령은 텍스트 gcm, 별칭을 포함하는 별칭을 표시합니다 Get-Command.

Get-Alias | Out-String -Stream | Select-String -Pattern "gcm"

Alias           gcm -> Get-Command

Get-Alias는 각 별칭에 대해 하나씩 System.Management.Automation.AliasInfo 개체를 가져오고 파이프라인 아래로 개체를 보냅니다. Out-String 에서는 Stream 매개 변수를 사용하여 모든 개체를 단일 문자열로 연결하지 않고 각 개체를 문자열로 변환합니다. System.String 개체는 파이프라인 아래로 전송되고 Select-String Pattern 매개 변수를 사용하여 텍스트 gcm에 대한 일치 항목을 찾습니다.

참고 항목

Stream 매개 변수를 생략하면 반환되는 단일 문자열에서 텍스트 gcm을 찾기 때문에 Select-String 모든 별칭이 Out-String 표시됩니다.

예제 3: Width 매개 변수를 사용하여 잘림을 방지합니다.

대부분의 출력 Out-String 은 다음 줄로 래핑되지만, 출력이 전달 Out-String되기 전에 서식 시스템에 의해 잘리는 시나리오가 있습니다. Width 매개 변수를 사용하여 잘림을 방지할 수 있습니다.

PS> @{TestKey = ('x' * 200)} | Out-String
Name                           Value
----                           -----
TestKey                        xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx...

PS> @{TestKey = ('x' * 200)} | Out-String -Width 250

Name                           Value
----                           -----
TestKey                        xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

매개 변수

-InputObject

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

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

-Stream

기본적으로 Out-String 빈 헤더 또는 후행 줄 바꿈을 포함하여 콘솔에서 볼 수 있는 것처럼 형식이 지정된 단일 문자열을 출력합니다. Stream 매개 변수를 Out-String 사용하면 각 줄을 하나씩 출력할 수 있습니다. 이에 대한 유일한 예외는 여러 줄 문자열입니다. 이 경우 Out-String 문자열을 단일 다중 줄 문자열로 출력합니다.

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

-Width

각 출력 줄의 문자 수를 지정합니다. 추가 문자는 다음 줄로 래핑되거나 사용된 포맷터 cmdlet에 따라 잘립니다. Width 매개 변수는 서식이 지정된 개체에만 적용됩니다. 이 매개 변수를 생략하면 너비는 호스트 프로그램의 특성에 따라 결정됩니다. 터미널(콘솔) 창에서 현재 창 너비가 기본값으로 사용됩니다. PowerShell 콘솔 창은 설치 시 기본적으로 너비가 80자입니다.

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

입력

PSObject

모든 개체를 이 cmdlet으로 파이프할 수 있습니다.

출력

String

이 cmdlet은 입력 개체에서 만든 문자열을 반환합니다.

참고

동사가 포함된 cmdlet은 개체의 Out 서식을 지정하지 않습니다. cmdlet은 Out 지정된 표시 대상의 포맷터에 개체를 보냅니다.