다음을 통해 공유

Write-Output

모듈:
Microsoft.PowerShell.Utility Module

지정된 객체를 파이프라인에 기록합니다.

구문

Default (기본값) 

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

Description

지정된 객체를 파이프라인에 기록합니다. Write-Output 파이프라인의 마지막 명령이면 개체가 콘솔에 표시됩니다.

Write-Output 개체를 주 파이프라인(성공 스트림이라고도 함)으로 보냅니다. 오류 스트림에 오류 개체를 보내려면 Write-Error사용합니다.

이 cmdlet은 일반적으로 스크립트에서 콘솔에 문자열 및 기타 개체를 표시하는 데 사용됩니다. Write-Output의 기본 제공 별칭 중 하나는 echo이며, 이는 echo를 사용하는 다른 셸과 유사합니다. 기본 동작은 파이프라인의 끝에 출력을 표시하는 것입니다. PowerShell에서는 일반적으로 출력이 기본적으로 표시되는 인스턴스에서 cmdlet을 사용할 필요가 없습니다. 예를 들어 Get-Process | Write-Output는 Get-Process와 같습니다. 또는 echo "Home directory: $HOME"을 "Home directory: $HOME"으로 쓸 수 있습니다.

기본적으로 Write-Output 컬렉션의 개체를 열거합니다. 그러나 Write-OutputNoEnumerate 매개 변수를 사용하여 컬렉션을 단일 개체로 파이프라인 아래로 전달할 수도 있습니다.

예제

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

이 예제에서는 Get-Process cmdlet의 결과가 $P 변수에 저장됩니다. Write-Output cmdlet은 콘솔에 $P 프로세스 개체를 표시합니다.

$P = Get-Process
Write-Output $P

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

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

Write-Output "test output" | Get-Member

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

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

Write-Output 1,2,3 | Measure-Object

Count    : 3
...

Write-Output 1,2,3 -NoEnumerate | Measure-Object

Count    : 1
...

매개 변수

-InputObject

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

매개 변수 속성

형식:

PSObject[]

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

매개 변수 집합

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

-NoEnumerate

기본적으로 Write-Output cmdlet은 항상 출력을 열거합니다. NoEnumerate 매개 변수는 기본 동작을 억제하고 Write-Output가 출력을 열거하지 못하도록 합니다. 명령이 괄호로 감싸지면 괄호가 열거를 강제하기 때문에 NoEnumerate 매개 변수는 효과가 없습니다. 예를 들어 (Write-Output 1,2,3 -NoEnumerate) 여전히 배열을 열거합니다.

NoEnumerate 매개 변수는 파이프라인 내에서만 유용합니다. PowerShell이 모든 명령줄의 끝에 를 추가하여 열거가 발생하므로 콘솔에서 Out-Default의 효과를 관찰하려고 시도하면 어려움이 있습니다. 다만, Write-Output -NoEnumerate을 다른 cmdlet으로 파이프로 연결하는 경우, 다운스트림 cmdlet은 컬렉션의 열거된 항목이 아닌 컬렉션 개체를 받게 됩니다.

매개 변수 속성

형식:SwitchParameter
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으로 파이핑할 수 있습니다.

출력

PSObject

이 cmdlet은 입력으로 제출된 개체를 반환합니다.

참고

PowerShell에는 Write-Output에 대한 다음과 같은 별칭들이 포함되어 있습니다.

  • 모든 플랫폼:

    • echo

  • Windows:

    • write