다음을 통해 공유

Write-Output

  • 참조
모듈:
Microsoft.PowerShell.Utility

지정된 개체를 파이프라인의 다음 명령으로 보냅니다. 명령이 파이프라인의 마지막 명령인 경우 개체가 콘솔에 표시됩니다.

구문

Write-Output
     [-InputObject] <PSObject[]>
     [-NoEnumerate]
     [<CommonParameters>]

Description

Write-Output cmdlet은 지정된 개체를 파이프라인 아래로 다음 명령으로 보냅니다. 명령이 파이프라인의 마지막 명령인 경우 개체가 콘솔에 표시됩니다.

쓰기 출력 "출력 스트림" 또는 "성공 파이프라인"이라고도 하는 기본 파이프라인 아래로 개체를 보냅니다. 오류 파이프라인 아래로 오류 개체를 보내려면 Write-Error를 사용합니다.

이 cmdlet은 일반적으로 스크립트에서 콘솔에 문자열 및 기타 개체를 표시하는 데 사용됩니다. 그러나 기본 동작은 파이프라인의 끝에 개체를 표시하는 것이므로 일반적으로 cmdlet을 사용할 필요가 없습니다. 예를 들어 Get-Process | Write-OutputGet-Process동일합니다.

예제

예제 1: 개체 가져오기 및 콘솔에 쓰기

PS C:\> $P = Get-Process
PS C:\> Write-Output $P
PS C:\> $P

첫 번째 명령은 컴퓨터에서 실행되는 프로세스를 가져오고 $P 변수에 저장합니다.

두 번째 및 세 번째 명령은 콘솔의 $P 프로세스 개체를 표시합니다.

예제 2: 출력을 다른 cmdlet에 전달

PS C:\> Write-Output "test output" | Get-Member

이 명령은 "test output" 문자열을 Get-Member cmdlet으로 파이프합니다. 이 cmdlet은 System.String 클래스의 멤버를 표시하여 문자열이 파이프라인을 따라 전달되었음을 보여 줍니다.

예제 3: 출력에서 열거형 표시 안 함

PS C:\> Write-Output @(1,2,3) | measure

Count    : 3
...

PS C:\> Write-Output @(1,2,3) -NoEnumerate | measure

Count    : 1

이 명령은 파이프라인을 통해 컬렉션 또는 배열을 단일 개체로 처리하는 NoEnumerate 매개 변수를 추가합니다.

매개 변수

-InputObject

파이프라인을 보낼 개체를 지정합니다. 개체가 포함된 변수를 입력하거나 개체를 가져오는 명령이나 식을 입력합니다.

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

-NoEnumerate

기본적으로 쓰기 출력 cmdlet은 항상 해당 출력을 열거합니다. NoEnumerate 매개 변수는 기본 동작을 표시하지 않으며 쓰기 출력 출력을 열거하지 못하게 합니다. 괄호가 강제로 열거되므로 NoEnumerate 매개 변수는 명령을 괄호로 래핑하여 만든 컬렉션에 영향을 주지 않습니다.

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

입력

PSObject

개체를 쓰기 출력파이프할 수 있습니다.

출력

PSObject

쓰기 출력 입력으로 제출된 개체를 반환합니다.