Out-GridView

모듈:: Microsoft.PowerShell.Utility Module

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

구문

PassThru (기본값)

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

Wait

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

OutputMode

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

Description

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

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

이 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

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

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

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

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

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

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

다음은 cmdlet 출력을 변수에 저장한 다음 Out-GridView보내는 예제입니다.

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

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

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

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

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

이 예제에서는 ogv cmdlet의 별칭인 Out-GridView사용합니다. 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

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

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

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

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

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

매개 변수

-InputObject

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

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

매개 변수 속성

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

매개 변수 집합

(All)

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

-OutputMode

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

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

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

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

매개 변수 속성

형식:	OutputModeOption
Default value:	None
허용되는 값:	None, Single, Multiple
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

OutputMode

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-PassThru

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

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

매개 변수 속성

형식:	SwitchParameter
Default value:	False
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

PassThru

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-Title

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

매개 변수 속성

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

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-Wait

cmdlet이 명령 프롬프트를 표시하지 않으며 Out-GridView 창을 닫을 때까지 Windows PowerShell이 닫히지 않도록 합니다. 기본적으로 명령 프롬프트는 Out-GridView 창이 열리면 반환됩니다.

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

매개 변수 속성

형식:	SwitchParameter
Default value:	False
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

Wait

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

CommonParameters

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

입력

PSObject

모든 객체를 이 cmdlet에 파이핑할 수 있습니다.

출력

None

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

PSObject

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

참고

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

Windows:
- ogv

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

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

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

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

Out-GridView바로 가기 키

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

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

열을 숨기거나 표시하려면

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

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

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

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

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

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

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

행을 선택하려면 행을 선택하거나 위쪽 또는 아래쪽 화살표를 사용하여 행으로 이동합니다.
머리글 행을 제외한 모든 행을 선택하려면 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연결됩니다. 논리 커넥터는 변경할 수 없습니다.

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

조건 추가하는 방법

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

조건 편집하는 방법

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

조건 삭제하는 방법

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

피드백

이 페이지가 도움이 되었나요?

다음을 통해 공유

Out-GridView

구문

PassThru (기본값)

Wait

OutputMode

Description

예제

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

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

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

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

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

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

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

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

매개 변수

-InputObject

매개 변수 속성

매개 변수 집합

-OutputMode

매개 변수 속성

매개 변수 집합

-PassThru

매개 변수 속성

매개 변수 집합

-Title

매개 변수 속성

매개 변수 집합

-Wait

매개 변수 속성

매개 변수 집합

CommonParameters

입력

PSObject

출력

None

PSObject

참고

관련 링크

피드백