다음을 통해 공유

Write-Information

모듈:
Microsoft.PowerShell.Utility Module

Windows PowerShell이 명령에 대한 정보 스트림 데이터를 처리하는 방법을 지정합니다.

구문

Default (기본값) 

Write-Information
    [-MessageData] <Object>
    [[-Tags] <String[]>]
    [<CommonParameters>]

Description

Write-Information cmdlet은 Windows PowerShell이 명령에 대한 정보 스트림 데이터를 처리하는 방법을 지정합니다.

Windows PowerShell 5.0에는 스크립트와 해당 호출자(또는 호스팅 환경) 간에 구조적 데이터를 전송하는 데 사용할 수 있는 새로운 구조적 정보 스트림(Windows PowerShell 스트림의 6번)이 도입되었습니다. Write-Information 스트림에 정보 메시지를 추가하고 Windows PowerShell에서 명령에 대한 정보 스트림 데이터를 처리하는 방법을 지정할 수 있습니다. 정보 스트림은 PowerShell.Streams, 작업, 예약된 작업 및 워크플로에도 작동합니다.

비고

정보 스트림은 "[Stream Name]:"을 사용하여 메시지를 접두사로 지정하는 표준 규칙을 따르지 않습니다. 간결하고 시각적인 청결을 위한 것이었습니다.

$InformationPreference 기본 설정 변수의 값은 Write-Information에 제공하는 메시지가 스크립트 실행의 예상 지점에 표시되는지 여부를 결정합니다. 이 변수의 기본값은 SilentlyContinue때문에 기본적으로 정보 메시지는 표시되지 않습니다. $InformationPreference값을 변경하지 않으려면 명령에 InformationAction 공통 매개 변수를 추가하여 해당 값을 재정의할 수 있습니다. 자세한 내용을 보려면 about_Preference_Variables 및 about_CommonParameters를 참조하세요.

비고

Windows PowerShell 5.0부터 Write-Host는 Write-Information을 위한 래퍼입니다. 이를 통해 Write-Host를 사용하여 정보 스트림으로 출력을 발생시킬 수 있습니다. 이렇게 하면 이전 버전과의 호환성을 유지하면서 사용하여 작성된 데이터의 캡처 또는 Write-Host 수 있습니다. 자세한 내용은 Write-Host 참조하세요.

Write-Information 지원되는 워크플로 활동이기도 합니다.

예제

예제 1: Get- 결과에 대한 정보 작성

Get-WindowsFeature -Name p*; Write-Information -MessageData "Got your features!" -InformationAction Continue

Display Name                                            Name                       Install State
------------                                            ----                       -------------
[ ] Print and Document Services                         Print-Services                 Available
    [ ] Print Server                                    Print-Server                   Available
    [ ] Distributed Scan Server                         Print-Scan-Server              Available
    [ ] Internet Printing                               Print-Internet                 Available
    [ ] LPD Service                                     Print-LPD-Service              Available
[ ] Peer Name Resolution Protocol                       PNRP                           Available
[X] Windows PowerShell                                  PowerShellRoot                 Installed
    [X] Windows PowerShell 5.0                          PowerShell                     Installed
    [ ] Windows PowerShell 2.0 Engine                   PowerShell-V2                    Removed
    [X] Windows PowerShell ISE                          PowerShell-ISE                 Installed
Got your features!

이 예제에서는 Get-WindowsFeature 명령을 실행한 후 'p'로 시작하는 Name 값이 있는 모든 기능을 찾은 후 "기능을 얻었습니다!"라는 정보 메시지를 표시합니다. $InformationPreference 변수는 여전히 기본값인 SilentlyContinue설정되므로 InformationAction 매개 변수를 추가하여 $InformationPreference 값을 재정의하고 메시지를 표시합니다. InformationAction 값은 Continue입니다. 즉, 메시지가 표시되지만 스크립트 또는 명령이 아직 완료되지 않은 경우 계속 진행됩니다.

예제 2: 정보 작성 및 태그 지정

Get-WindowsFeature -Name p*; Write-Information -MessageData "To filter your results for PowerShell, pipe your results to the Where-Object cmdlet." -Tags "Instructions" -InformationAction Continue

Display Name                                            Name                       Install State
------------                                            ----                       -------------
[ ] Print and Document Services                         Print-Services                 Available
    [ ] Print Server                                    Print-Server                   Available
    [ ] Distributed Scan Server                         Print-Scan-Server              Available
    [ ] Internet Printing                               Print-Internet                 Available
    [ ] LPD Service                                     Print-LPD-Service              Available
[ ] Peer Name Resolution Protocol                       PNRP                           Available
[X] Windows PowerShell                                  PowerShellRoot                 Installed
    [X] Windows PowerShell 5.0                          PowerShell                     Installed
    [ ] Windows PowerShell 2.0 Engine                   PowerShell-V2                    Removed
    [X] Windows PowerShell ISE                          PowerShell-ISE                 Installed
To filter your results for PowerShell, pipe your results to the Where-Object cmdlet.

이 예제에서는 Write-Information 사용하여 사용자가 현재 명령 실행을 완료한 후 다른 명령을 실행해야 한다는 것을 알릴 수 있습니다. 이 예제에서는 정보 메시지에 태그 지침을 추가합니다. 이 명령을 실행한 후 지침에 태그가 지정된 메시지에 대한 정보 스트림을 검색하면 여기에 지정된 메시지가 결과 중 하나입니다.

예제 3: 파일에 정보 쓰기

function Test-Info
{
    Get-Process P*
    Write-Information "Here you go"
}
Test-Info 6> Info.txt

이 예제에서는 코드 6>사용하여 함수의 정보 스트림을 Info.txt파일로 리디렉션합니다. Info.txt 파일을 열면 "여기로 이동하세요"라는 텍스트가 표시됩니다.

매개 변수

-MessageData

스크립트 또는 명령을 실행할 때 사용자에게 표시할 정보 메시지를 지정합니다. 최상의 결과를 위해 정보 메시지를 따옴표로 묶습니다. 예를 들어 "테스트 완료"가 있습니다.

매개 변수 속성

형식:Object
Default value:None
와일드카드 지원:False
DontShow:False
별칭:메시지

매개 변수 집합

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

-Tags

Write-Information사용하여 정보 스트림에 추가한 메시지를 정렬하고 필터링하는 데 사용할 수 있는 간단한 문자열을 지정합니다. 이 매개변수는 의 New-ModuleManifest 매개변수와 유사하게 작동합니다.

매개 변수 속성

형식:

String[]

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

매개 변수 집합

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

CommonParameters

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

입력

None

Write-Information 파이프 입력을 허용하지 않습니다.

출력

InformationRecord