다음을 통해 공유

Out-String

모듈:
Microsoft.PowerShell.Utility Module

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

구문

All 

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

Description

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

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

예제

예제 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 매개 변수를 사용하여 변수에 저장된 $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-StringPattern 매개 변수를 사용하여 텍스트 gcm일치하는 항목을 찾습니다.

비고

Stream 매개 변수를 생략하면 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
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:True
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-Stream

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

매개 변수 속성

형식:SwitchParameter
Default value:False
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-Width

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

매개 변수 속성

형식:Int32
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

CommonParameters

이 cmdlet은 일반적인 매개 변수인 -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction 및 -WarningVariable 매개 변수를 지원합니다. 자세한 내용은 about_CommonParameters를 참조하세요.

입력

PSObject

모든 객체를 이 cmdlet에 파이핑할 수 있습니다.

출력

String

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

참고

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