다음을 통해 공유


Out-GridView

별도의 창에서 대화형 테이블로 출력을 보냅니다.

구문

Out-GridView
   [-InputObject <PSObject>]
   [-Title <String>]
   [-PassThru]
   [<CommonParameters>]
Out-GridView
   [-InputObject <PSObject>]
   [-Title <String>]
   [-Wait]
   [<CommonParameters>]
Out-GridView
   [-InputObject <PSObject>]
   [-Title <String>]
   [-OutputMode <OutputModeOption>]
   [<CommonParameters>]

Description

이 cmdlet은 Windows 플랫폼에서만 사용할 수 있습니다.

cmdlet은 Out-GridView 명령의 출력을 대화형 테이블에 출력이 표시되는 그리드 보기 창으로 보냅니다.

이 cmdlet에는 사용자 인터페이스가 필요하므로 Windows Server Core 또는 Windows Nano Server에서는 작동하지 않습니다.

테이블의 다음 기능을 사용하여 데이터를 검사할 수 있습니다.

  • 열 숨기기, 표시 및 순서 다시 지정
  • 행 정렬
  • 빠른 필터
  • 조건 필터 추가
  • 복사 및 붙여넣기

전체 지침은 이 문서의 노트 섹션을 참조하세요.

참고 항목

이 cmdlet은 PowerShell 7에서 다시 도입되었습니다. 이 cmdlet은 Windows 데스크톱을 지원하는 Windows 시스템에서만 사용할 수 있습니다. 이 cmdlet의 플랫폼 간 버전은 PowerShell 갤러리 ConsoleGuiTools 모듈을 참조하세요.

예제

예제 1: 그리드 보기에 프로세스 출력

이 예제에서는 로컬 컴퓨터에서 실행 중인 프로세스를 가져오고 그리드 보기 창으로 보냅니다.

Get-Process | Out-GridView

예제 2: 변수를 사용하여 그리드 보기에 프로세스 출력

또한 이 예제에서는 로컬 컴퓨터에서 실행 중인 프로세스를 가져오고 그리드 보기 창으로 보냅니다.

$P = Get-Process
$P | Out-GridView

cmdlet의 Get-Process 출력은 변수에 $P 저장됩니다. 그런 다음, $P 에 파이프됩니다 Out-GridView.

예제 3: 그리드 보기에서 선택한 속성 표시

다음은 그리드 보기에서 실행 중인 프로세스의 선택한 속성을 표시하는 예제입니다.

Get-Process | Select-Object -Property Name, WorkingSet, PeakWorkingSet |
  Sort-Object -Property WorkingSet -Descending | Out-GridView

Get-Process 출력은 Name, WorkingSet 및 PeakWorkingSet 속성을 선택하기 위해 Select-Object 파이프됩니다. 다른 파이프라인 연산자는 필터링된 개체를 Sort-Object cmdlet에 보내서 WorkingSet 속성 값으로 내림차순으로 정렬합니다. 그런 다음 정렬된 결과가 .에 Out-GridView파이프됩니다. 그런 다음에는 그리드 뷰의 기능을 사용하여 데이터를 검색, 정렬 및 필터링할 수 있습니다.

예제 4: 변수에 출력을 저장한 다음 그리드 뷰 출력

이 예제에서는 cmdlet 출력을 변수에 저장한 다음, 로 Out-GridView보냅니다.

($A = Get-ChildItem -Path $PSHOME -Recurse) | Out-GridView

Get-ChildItem 는 자동 변수를 사용하여 $PSHOME PowerShell 설치 디렉터리의 모든 파일과 해당 하위 디렉터리를 가져옵니다. 명령의 괄호는 작업 순서를 설정합니다. 따라서 명령의 출력 Get-ChildItem 은 변수로 전송Out-GridView되기 전에 변수에 $A 저장됩니다.

예제 5: 그리드 보기에 지정된 컴퓨터에 대한 출력 프로세스

다음은 Server01 컴퓨터에서 실행되는 프로세스를 그리드 보기 창에 표시하는 예제입니다.

Get-Process -ComputerName "Server01" | ogv -Title "Processes - Server01"

이 예제에서는 cmdlet의 별칭 Out-GridView 인 이 값을 사용합니다ogv. Title 매개 변수는 창 제목을 지정합니다.

예제 6: 원격 컴퓨터에서 그리드 보기로 데이터 출력

이 예제에서는 원격 컴퓨터 Out-GridView에서 수집된 데이터를 .

Invoke-Command -ComputerName S1, S2, S3 -ScriptBlock {Get-Culture} | Out-GridView

Invoke-Command 는 3개의 원격 컴퓨터에서 실행됩니다 Get-Culture . 결과 데이터는 .에 Out-GridView파이프됩니다. 원격 컴퓨터에서 실행되는 스크립트 블록에는 명령이 Out-GridView 포함되지 않습니다. 이 경우 각 원격 컴퓨터에서 그리드 보기 창을 열려고 하면 명령이 실패합니다.

예제 7: 'Out-GridView'를 통해 여러 항목 전달

이 예제에서는 창에서 여러 프로세스를 선택할 수 있습니다 Out-GridView . 선택한 프로세스는 명령에 전달되고 Export-Csv 파일에 기록 ProcessLog.csv 됩니다.

Get-Process | Out-GridView -PassThru | Export-Csv -Path .\ProcessLog.csv

PassThru 매개 변수를 Out-GridView 사용하면 파이프라인 아래로 여러 항목을 보낼 수 있습니다. PassThru 매개 변수는 OutputMode 매개 변수의 Multiple 값을 사용하는 것과 같습니다.

예제 8: 'Out-GridView'에 대한 Windows 바로 가기 만들기

이 예제에서는 Wait 매개 변수 Out-GridView사용하여 창에 대한 Windows 바로 가기를 만드는 방법을 보여 줍니다Out-GridView.

pwsh -Command "Get-Service | Out-GridView -Wait"

이 명령줄은 Windows 바로 가기에서 사용할 수 있습니다. Wait 매개 변수가 없으면 창이 열리자마자 Out-GridView PowerShell이 종료되어 창이 Out-GridView 거의 즉시 닫힙니다.

매개 변수

-InputObject

cmdlet이 입력으로 허용하는 개체를 Out-GridView지정합니다.

InputObject 매개 변수를 사용하여 개체 Out-GridViewOut-GridView 컬렉션을 보낼 때 컬렉션을 하나의 컬렉션 개체로 처리하고 컬렉션을 나타내는 하나의 행을 표시합니다. 컬렉션의 각 개체를 표시하려면 파이프라인 연산자(|)를 사용하여 개체를 Out-GridView보냅니다.

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

-OutputMode

대화형 창이 파이프라인 아래로 다른 명령에 대한 입력으로 보내는 항목을 지정합니다. 기본적으로 이 cmdlet은 출력을 생성하지 않습니다. 대화형 창에서 파이프라인 아래로 항목을 보내려면 클릭하여 항목을 선택한 다음 확인을 클릭합니다.

이 매개 변수의 값은 파이프라인 아래로 보낼 수 있는 항목 수를 결정합니다.

  • None. 항목이 없습니다. 기본값입니다.
  • Single. 항목 0개 또는 항목 1개 다음 명령에서 입력 개체를 하나만 사용할 수 있는 경우 이 값을 사용합니다.
  • Multiple. 0개, 1개 또는 여러 항목입니다. 다음 명령에서 여러 개의 입력 개체를 사용할 수 있는 경우 이 값을 사용합니다. 이 값은 PassThru 매개 변수와 동일합니다.

이 매개 변수는 Windows PowerShell 3.0에서 도입되었습니다.

형식:OutputModeOption
허용되는 값:None, Single, Multiple
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-PassThru

cmdlet이 대화형 창의 항목을 파이프라인 아래로 다른 명령에 대한 입력으로 보내도록 나타냅니다. 기본적으로 이 cmdlet은 출력을 생성하지 않습니다. 이 매개 변수는 OutputMode 매개 변수의 Multiple 값을 사용하는 것과 같습니다.

대화형 창에서 파이프라인 아래로 항목을 보내려면 클릭하여 항목을 선택한 다음 확인을 클릭합니다. Shift 키를 누른 채 클릭하고 Ctrl 키를 누른 채로 클릭할 수 있습니다.

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

-Title

창의 제목 표시줄에 표시되는 텍스트를 지정합니다 Out-GridView . 기본적으로 제목 표시줄에는 호출 Out-GridView하는 명령이 표시됩니다.

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

-Wait

cmdlet이 명령 프롬프트를 표시하지 않으며 창이 닫힙니다 Out-GridView . 기본적으로 명령 프롬프트는 창이 Out-GridView 열리면 반환됩니다.

이 기능을 사용하면 Windows 바로 가기에서 Out-GridView cmdlet을 사용할 수 있습니다. Wait 매개 변수가 없는 바로 가기에서 사용되는 경우 Out-GridView PowerShell이 Out-GridView 닫히기 전에 창이 잠시만 나타납니다.

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

입력

PSObject

모든 개체를 이 cmdlet으로 파이프할 수 있습니다.

출력

None

기본적으로 이 cmdlet은 출력을 반환하지 않습니다.

PSObject

PassThru 매개 변수를 사용하는 경우 이 cmdlet은 선택한 행을 나타내는 개체를 반환합니다.

참고

PowerShell에는 다음 별칭이 포함됩니다.Out-GridView

  • Windows:
    • ogv

이 cmdlet은 Windows 플랫폼에서만 사용할 수 있습니다. 이 cmdlet은 Windows 플랫폼에서만 사용할 수 있습니다.

원격 명령을 사용하여 다른 컴퓨터에서 그리드 보기 창을 열 수 없습니다.

보내는 Out-GridView 명령 출력은 cmdlet(Format-Wide예: Format-Table cmdlet)을 사용하여 Format 서식을 지정할 수 없습니다. 속성을 선택하려면 cmdlet을 Select-Object 사용합니다.

원격 명령의 역직렬화된 출력은 그리드 보기 창에서 올바르게 형식이 지정되지 않을 수 있습니다.

바로 가기 키 Out-GridView

다음 키를 사용합니다. 이 작업을 수행하려면 다음을 수행합니다.
Tab 필터 상자에서 조건 추가 메뉴로 커서를 표로 이동하고 뒤로 이동합니다.
UpArrow 한 행 위로 이동합니다. 데이터의 첫 번째 행에서 열 머리글로 이동합니다.
DownArrow 한 행 아래로 이동합니다.
LeftArrow 열 머리글 행에서 한 열을 왼쪽으로 이동합니다.
RightArrow 열 머리글 행에서 한 열을 오른쪽으로 이동합니다.
ContextMenuKey 열 머리글 행에 열 선택 옵션이 표시됩니다.
Enter 또는 스페이스바 열 머리글 행에서 열 데이터(A-Z, Z-A 토글)를 정렬합니다.

그리드 보기 창 기능을 사용하는 방법

열을 숨기거나 표시하려면 다음을 수행합니다.

  1. 열 머리글을 마우스 오른쪽 단추로 클릭하고 열 선택을 클릭합니다.
  2. 선택 대화 상자에서 화살표 키를 사용하여 선택한 열 사이의 열을 사용 가능한 열 상자로 이동합니다. 열 선택 상자의 만 눈금 보기 창에 표시됩니다.

열의 순서를 다시 지정하려면:

열을 원하는 위치로 끌어서 놓을 수 있습니다. 또는 다음 단계를 사용합니다.

  1. 열 머리글을 마우스 오른쪽 단추로 클릭하고 열 선택을 클릭합니다.
  2. 선택 대화 상자에서 위로 이동 및 아래로 이동 단추를 사용하여 열의 순서를 변경합니다. 목록 맨 위에 있는 열은 그리드 보기 창의 목록 맨 아래에 있는 열 왼쪽에 나타납니다.

테이블 데이터를 정렬하는 방법

  • 데이터를 정렬하려면 열 머리글을 클릭합니다.
  • 정렬 순서를 변경하려면 열 머리글을 다시 클릭합니다. 동일한 헤더를 클릭할 때마다 정렬 순서가 오름차순에서 내림차순으로 전환됩니다. 현재 순서는 열 머리글의 삼각형으로 표시됩니다.

테이블 데이터를 선택하는 방법

  • 행을 선택하려면 행을 선택하거나 위쪽 또는 아래쪽 화살표를 사용하여 행으로 이동합니다.
  • 머리글 행을 제외한 모든 행을 선택하려면 Ctrl+A를 누릅니다.
  • 연속 행을 선택하려면 Shift 키를 누른 채 행을 클릭하거나 화살표 키를 사용합니다.
  • 비보안 행을 선택하려면 Ctrl 키를 누른 다음 클릭하여 선택 영역에 행을 추가합니다.
  • 열을 선택할 수 없으며 전체 열 머리글 행을 선택할 수 없습니다.

행을 복사하는 방법

  • 테이블에서 하나 이상의 행을 복사하려면 행을 선택한 다음 Ctrl+C를 누릅니다.

    모든 텍스트 또는 스프레드시트 프로그램에 데이터를 붙여넣을 수 있습니다. 열 또는 행의 일부나 열 머리글 행은 복사할 수 없습니다.

테이블에서 검색하는 방법(빠른 필터)

필터 상자를 사용하여 테이블에서 데이터를 검색합니다. 상자에 입력하면 입력된 텍스트가 포함된 항목만 표에 표시됩니다.

  • 텍스트를 검색합니다. 표에서 텍스트를 검색하려면 필터 상자에 찾을 텍스트를 입력합니다.

  • 여러 단어를 검색합니다. 테이블에서 여러 단어를 검색하려면 공백으로 구분된 단어를 입력합니다. Out-GridView 는 모든 단어(논리적 AND)를 포함하는 행을 표시합니다.

  • 리터럴 구를 검색합니다. 공백이나 특수 문자가 포함된 구를 검색하려면 구를 따옴표로 묶어 입력합니다. Out-GridView 는 구와 정확히 일치하는 행을 표시합니다.

  • 열에서 검색합니다. 하나 이상의 열에서 텍스트를 검색하려면 다음 형식을 사용합니다.

    <column>:<text> [<column>:<text>] ...

    예를 들어 DisplayName 열에서 "Net"을 찾으려면 필터 상자에 다음을 입력합니다.

    displayname:net

    DisplayName 및 이름 열에서 "Net"이 있는 행을 찾으려면 필터 상자에 다음을 입력합니다.

    displayname:net name:net

  • 검색을 끕니다. 전체 표를 다시 표시하려면 필터 상자의 오른쪽 위 모서리에 있는 빨간색 X 단추를 클릭하거나 필터 상자에서 텍스트를 삭제합니다.

조건을 사용하여 테이블 필터링

규칙 또는 조건을 사용하여 테이블에 표시되는 항목을 확인할 수 있습니다. 항목은 사용자가 설정한 모든 조건을 충족하는 경우에만 표시됩니다. 사용 가능한 조건은 그리드 보기 창에 표시되는 개체의 속성 및 해당 속성의 .NET Framework 형식에 따라 결정됩니다.

각 기준의 형식은 다음과 같습니다.

<column> <operator> <value>

다른 속성에 대한 조건은 AND에 의해 연결됩니다. 동일한 속성에 대한 조건은 OR에 의해 연결됩니다. 논리 커넥터는 변경할 수 없습니다.

조건은 디스플레이에만 영향을 줍니다. 테이블에서 항목을 삭제하지 않습니다.

조건을 추가하는 방법

  1. 조건 추가 메뉴 단추를 표시하려면 창의 오른쪽 위 모서리에서 확장 화살표를 클릭합니다.
  2. 조건 추가 메뉴 단추를 클릭합니다.
  3. 열(속성)을 클릭하여 선택합니다. 하나 이상의 속성을 선택할 수 있습니다.
  4. 속성 선택을 마쳤으면 추가 단추를 클릭합니다.
  5. 추가를 취소하려면 [취소]를 클릭합니다.
  6. 조건을 더 추가하려면 조건 추가 단추를 다시 클릭합니다.

조건을 편집하는 방법

  • 연산자를 변경하려면 파란색 연산자 값을 클릭한 다음 드롭다운 목록에서 다른 연산자를 선택합니다.
  • 값을 입력하거나 변경하려면 값 상자에 값을 입력합니다. 유효하지 않은 값을 입력하면 순환 X 아이콘이 나타납니다. 값을 제거하려면 변경하세요.
  • OR 문을 만들려면 동일한 속성을 가진 조건을 추가합니다.

조건을 삭제하는 방법

  • 선택한 조건을 삭제하려면 각 조건 옆에 있는 빨간색 X를 클릭합니다.
  • 모든 조건을 삭제하려면 모두 지우기 단추를 클릭합니다.