쓰기-출력 (Microsoft.PowerShell.Utility)-PowerShell | Microsoft Docs

모듈 : Microsoft.PowerShell.Utility

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

구문

Description

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

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는 cmdlet에 제공된 컬렉션을 열거합니다. 그러나 Write-Output를 사용하여 NoEnumerate 매개 변수를 사용하여 단일 객체로 파이프 라인 아래로 컬렉션을 전달할 수도 있습니다.

예

예 1 : 개체를 가져 와서 콘솔에 작성

첫 번째 명령은 컴퓨터에서 실행중인 프로세스를 가져와 $P 변수.

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

예 2 : 출력 통과 다른 cmdlet으로

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

예 3 : 출력에서 열거 억제

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

Parameters

-InputObject

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

유형 :	PSObject
위치 :	0
기본값 :	없음
파이프 라인 입력 허용 :	True
와일드 카드 문자 허용 :	False

-NoEnumerate

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

참고

이 스위치는 PowerShell Core 6.2 이상에서만 올바르게 작동합니다. 이전 버전의 PowerShell Core에서는이 스위치를 사용해도 컬렉션이 여전히 열거됩니다.

유형 :	SwitchParameter
위치 :	명명
기본값 :	없음
파이프 라인 입력 허용 :	False
와일드 카드 문자 허용 :	False

입력

PSObject

다음을 수행 할 수 있습니다. 개체를 Write-Output로 파이프합니다.

출력