다음을 통해 공유

Write-Information

  • 참조
모듈:
Microsoft.PowerShell.Utility

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

구문

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

Description

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

Windows PowerShell 5.0에는 구조화된 새로운 정보 스트림이 도입되었습니다. 이 스트림을 사용하여 스크립트와 해당 호출자 또는 호스트 애플리케이션 간에 구조적 데이터를 전송할 수 있습니다. Write-Information 스트림에 정보 메시지를 추가하고 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 참조하십시오.

예제

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

이 예제에서는 'p'로 시작하는 Name 값이 있는 모든 프로세스를 찾기 위해 Get-Process 명령을 실행하기 전에 "'P'로 시작하는 프로세스"라는 정보 메시지를 표시합니다. $InformationPreference 변수는 여전히 기본값 SilentlyContinue로 설정되어 있으므로 InformationAction 매개 변수를 추가하여 $InformationPreference 값을 재정의하고 메시지를 표시합니다. InformationAction 값은 Continue입니다. 즉, 메시지가 표시되지만, 스크립트나 명령이 아직 완료되지 않았을 경우 계속 실행됩니다.

Write-Information -MessageData "Processes starting with 'P'" -InformationAction Continue
Get-Process -Name p*

Processes starting with 'P'

     18    19.76      15.16       0.00    6232   0 PFERemediation
     20     8.92      25.15       0.00   24944   0 policyHost
      9     1.77       7.64       0.00    1780   0 powercfg
     10    26.67      32.18       0.00    7028   0 powercfg
      8    26.55      31.59       0.00   13600   0 powercfg
      9     1.66       7.55       0.00   22620   0 powercfg
     21     6.17       4.54     202.20   12536   1 PowerMgr
     42    84.26      12.71   2,488.84   20588   1 powershell
     27    47.07      45.38       2.05   25988   1 powershell
     27    24.45       5.31       0.00   12364   0 PresentationFontCache
     92   112.04      13.36      82.30   13176   1 pwsh
    106   163.73      93.21     302.25   14620   1 pwsh
    227   764.01      92.16   1,757.22   25328   1 pwsh

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

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

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

NPM(K)    PM(M)      WS(M)     CPU(s)      Id  SI ProcessName
 ------    -----      -----     ------      --  -- -----------
     18    19.76      15.16       0.00    6232   0 PFERemediation
     20     8.92      25.15       0.00   24944   0 policyHost
      9     1.77       7.64       0.00    1780   0 powercfg
     10    26.67      32.18       0.00    7028   0 powercfg
      8    26.55      31.59       0.00   13600   0 powercfg
      9     1.66       7.55       0.00   22620   0 powercfg
     21     6.17       4.54     202.20   12536   1 PowerMgr
     42    84.26      12.71   2,488.84   20588   1 powershell
     27    47.07      45.38       2.05   25988   1 powershell
     27    24.45       5.31       0.00   12364   0 PresentationFontCache
     92   112.04      13.36      82.30   13176   1 pwsh
    106   163.73      93.21     302.25   14620   1 pwsh
    227   764.01      92.16   1,757.22   25328   1 pwsh

To filter your results for PowerShell, pipe your results to the Where-Object cmdlet.

예제 3: 파일에 정보 쓰기

이 예제에서는 함수를 통해 코드 6>을 사용하여 정보 스트림을 Info.txt으로 전환합니다. Info.txt 파일을 열면 "여기에 있습니다"라는 텍스트가 표시됩니다.

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

예제 4: 정보를 기록하기 위해 개체 전달

이 예제에서는 Write-Information 사용하여 여러 파이프라인을 통과한 Get-Process 개체 출력에서 상위 10개의 가장 높은 CPU 사용률 프로세스를 작성할 수 있습니다.

Get-Process | Sort-Object CPU -Descending |
    Select-Object Id, ProcessName, CPU -First 10 |
    Write-Information -InformationAction Continue

@{Id=12692; ProcessName=chrome; CPU=39431.296875}
@{Id=21292; ProcessName=OUTLOOK; CPU=23991.875}
@{Id=10548; ProcessName=CefSharp.BrowserSubprocess; CPU=20546.203125}
@{Id=312848; ProcessName=Taskmgr; CPU=13173.1875}
@{Id=10848; ProcessName=SnapClient; CPU=7014.265625}
@{Id=9760; ProcessName=Receiver; CPU=6792.359375}
@{Id=12040; ProcessName=Teams; CPU=5605.578125}
@{Id=498388; ProcessName=chrome; CPU=3062.453125}
@{Id=6900; ProcessName=chrome; CPU=2546.9375}
@{Id=9044; ProcessName=explorer; CPU=2358.765625}

예제 5: 변수에 정보 레코드 저장

InformationVariable 매개 변수를 사용하여 정보 레코드를 변수에 저장할 수 있습니다. 이렇게 하면 스크립트의 뒷부분에서 정보 스트림 메시지를 검사할 수 있습니다.

Get-Process -Id $PID |
    Select-Object ProcessName, CPU, Path |
    Write-Information -Tags 'PowerShell' -InformationVariable 'InfoMsg'
$InfoMsg | Select-Object *

MessageData     : @{ProcessName=pwsh; CPU=12.36; Path=/opt/microsoft/powershell/7/pwsh}
Source          : Write-Information
TimeGenerated   : 10/19/2023 11:28:15
Tags            : {PowerShell}
User            : sdwheeler
Computer        : circumflex
ProcessId       : 237
NativeThreadId  : 261
ManagedThreadId : 10

매개 변수

-MessageData

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

형식:Object
별칭:Msg, Message
Position:0
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-Tags

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

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

입력

Object

이 cmdlet에 정보 스트림에 전달할 개체를 파이프할 수 있습니다.

출력

None

이 cmdlet은 출력을 반환하지 않습니다. 정보 메시지 스트림에만 씁니다.