다음을 통해 공유


Format-List

출력의 형식을 각 속성이 새 줄에 표시되는 속성 목록으로 지정합니다.

구문

Format-List
      [[-Property] <Object[]>]
      [-GroupBy <Object>]
      [-View <string>]
      [-ShowError][-DisplayError]
      [-Force]
      [-Expand <string>]
      [-InputObject <psobject>]
      [<CommonParameters>]

Description

Format-List cmdlet은 명령의 출력 형식을 각 속성이 별도의 줄에 표시되는 속성 목록으로 지정합니다. Format-List 사용하여 개체의 모든 속성 또는 선택한 속성을 목록으로 서식을 지정하고 표시할 수 있습니다(format-list *).

테이블보다 목록의 각 항목에 더 많은 공간을 사용할 수 있으므로 PowerShell은 목록에 개체의 속성을 더 많이 표시하고 속성 값은 잘릴 가능성이 적습니다.

예제

예제 1: 컴퓨터 서비스 서식 지정

Get-Service | Format-List

이 명령은 컴퓨터의 서비스에 대한 정보를 목록으로 서식을 지정합니다. 기본적으로 서비스는 테이블 형식으로 지정됩니다. Get-Service cmdlet은 컴퓨터의 서비스를 나타내는 개체를 가져옵니다. 파이프라인 연산자(|)는 파이프라인을 통해 결과를 전달하여 Format-List. 그런 다음, Format-List 명령은 목록의 서비스 정보의 서식을 지정하고 표시할 기본 출력 cmdlet으로 보냅니다.

예제 2: PS1XML 파일 서식 지정

이러한 명령은 PowerShell 디렉터리의 PS1XML 파일에 대한 정보를 목록으로 표시합니다.

$A = Get-ChildItem $pshome\*.ps1xml
Format-List -InputObject $A

첫 번째 명령은 파일을 나타내는 개체를 가져오고 $A 변수에 저장합니다.

두 번째 명령은 Format-List 사용하여 $A저장된 개체에 대한 정보의 형식을 지정합니다. 이 명령은 InputObject 매개 변수를 사용하여 변수를 Format-List전달한 다음 서식이 지정된 출력을 표시할 기본 출력 cmdlet으로 보냅니다.

예제 3: 이름별로 프로세스 속성 서식 지정

이 명령은 컴퓨터에서 각 프로세스의 이름, 기본 우선 순위 및 우선 순위 클래스를 표시합니다.

Get-Process | Format-List -Property name, basepriority, priorityclass

Get-Process cmdlet을 사용하여 각 프로세스를 나타내는 개체를 가져옵니다. 파이프라인 연산자(|)는 파이프라인을 통해 프로세스 개체를 전달하여 Format-List. Format-List 지정된 속성 목록으로 프로세스의 형식을 지정합니다. 속성 매개 변수 이름은 선택 사항이므로 생략할 수 있습니다.

예제 4: 프로세스의 모든 속성 서식 지정

이 명령은 Winlogon 프로세스의 모든 속성을 표시합니다.

Get-Process winlogon | Format-List -Property *

Get-Process cmdlet을 사용하여 Winlogon 프로세스를 나타내는 개체를 가져옵니다. 파이프라인 연산자(|)가 파이프라인을 통해 Winlogon 프로세스 개체를 전달하여 Format-List. 이 명령은 Property 매개 변수를 사용하여 속성을 지정하고 * 를 사용하여 모든 속성을 나타냅니다. Property 매개 변수의 이름은 선택 사항이므로 생략하고 명령을 Format-List *입력할 수 있습니다. Format-List 자동으로 결과를 표시할 기본 출력 cmdlet으로 보냅니다.

예제 5: 형식 오류 문제 해결

다음 예제에서는 식이 있는 DisplayError 또는 ShowError 매개 변수를 추가한 결과를 보여 줍니다.

PC /> Get-Date | Format-List DayOfWeek,{ $_ / $null } -DisplayError

DayOfWeek    : Friday
 $_ / $null  : #ERR

PC /> Get-Date | Format-List DayOfWeek,{ $_ / $null } -ShowError

DayOfWeek    : Friday
 $_ / $null  :

Failed to evaluate expression " $_ / $null ".
+ CategoryInfo          : InvalidArgument: (12/21/2018 7:59:23 AM:PSObject) [], RuntimeException
+ FullyQualifiedErrorId : PSPropertyExpressionError

매개 변수

-DisplayError

이 cmdlet이 명령줄에 오류를 표시한다는 것을 나타냅니다. 이 매개 변수는 거의 사용되지 않지만 Format-List 명령에서 식의 서식을 지정할 때 디버깅 보조로 사용할 수 있으며 식이 작동하지 않는 것처럼 보입니다.

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

-Expand

서식이 지정된 컬렉션 개체와 컬렉션의 개체를 지정합니다. 이 매개 변수는 ICollection(System.Collections) 인터페이스를 지원하는 개체의 서식을 지정하도록 설계되었습니다. 기본값은 EnumOnly입니다. 이 매개 변수에 허용되는 값은 다음과 같습니다.

  • EnumOnly. 컬렉션에 있는 개체의 속성을 표시합니다.
  • CoreOnly. 컬렉션 개체의 속성을 표시합니다.
  • 둘다. 컬렉션 개체의 속성과 컬렉션에 있는 개체의 속성을 표시합니다.
형식:String
허용되는 값:CoreOnly, EnumOnly, Both
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Force

이 cmdlet에 모든 오류 정보가 표시됨을 나타냅니다. DisplayError 또는 ShowError 매개 변수와 함께 사용합니다. 기본적으로 오류 개체가 오류 또는 표시 스트림에 기록되면 일부 오류 정보만 표시됩니다.

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

-GroupBy

공유 속성 또는 값을 기반으로 그룹의 출력을 지정합니다. 출력의 식 또는 속성을 입력합니다.

GroupBy 매개 변수의 값은 새 계산 속성일 수 있습니다. 계산된 속성을 만들려면 해시 테이블을 사용합니다. 유효한 키는 다음과 같습니다.

  • 이름(또는 레이블) <문자열>
  • 식 <문자열> 또는 <스크립트 블록>
  • FormatString <문자열>
형식:Object
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-InputObject

서식을 지정할 개체를 지정합니다. 개체를 포함하는 변수를 입력하거나 개체를 가져오는 명령이나 식을 입력합니다.

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

-Property

표시에 표시되는 개체 속성과 표시되는 순서를 지정합니다. 와일드카드가 허용됩니다.

이 매개 변수를 생략하면 표시에 표시되는 속성은 표시되는 개체에 따라 달라집니다. 매개 변수 이름 "Property"는 선택 사항입니다. 동일한 명령에서 속성보기 매개 변수를 사용할 수 없습니다.

Property 매개 변수의 값은 새 계산 속성일 수 있습니다. 계산된 속성을 만들려면 해시 테이블을 사용합니다. 유효한 키는 다음과 같습니다.

  • 이름(또는 레이블) <문자열>
  • 식 <문자열> 또는 <스크립트 블록>
  • FormatString <문자열>
형식:Object[]
Position:0
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:True

-ShowError

cmdlet이 파이프라인을 통해 오류를 보내도록 나타냅니다. 이 매개 변수는 거의 사용되지 않지만 Format-List 명령에서 식의 서식을 지정할 때 디버깅 보조로 사용할 수 있으며 식이 작동하지 않는 것처럼 보입니다.

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

-View

대체 목록 형식 또는 뷰의 이름을 지정합니다. 동일한 명령에서 속성보기 매개 변수를 사용할 수 없습니다.

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

입력

PSObject

모든 개체를 Format-List파이프할 수 있습니다.

출력

Microsoft.PowerShell.Commands.Internal.Format

Format-List 목록을 나타내는 서식 개체를 반환합니다.

참고

기본 제공 별칭인 FL로 Format-List 참조할 수도 있습니다. 자세한 내용은 about_Aliases참조하세요.

형식 cmdlet(예: Format-List)은 표시할 데이터를 정렬하지만 표시하지는 않습니다. 데이터는 PowerShell의 출력 기능과 out 동사(Out cmdlet)가 포함된 cmdlet(예: Out-Host 또는 Out-File)에 의해 표시됩니다.

형식 cmdlet을 사용하지 않는 경우 PowerShell은 표시되는 각 개체에 해당 기본 형식을 적용합니다.

GroupBy 매개 변수는 개체가 정렬된 것으로 가정합니다. Format-List 사용하여 개체를 그룹화하기 전에 Sort-Object 사용합니다.

View 매개 변수를 사용하면 테이블에 대한 대체 형식을 지정할 수 있습니다. PowerShell 디렉터리의 *.format.PS1XML 파일에 정의된 보기를 사용하거나 새 PS1XML 파일에서 고유한 보기를 만들고 Update-FormatData cmdlet을 사용하여 PowerShell에 포함할 수 있습니다.

View 매개 변수의 대체 뷰는 목록 형식을 사용해야 합니다. 그렇지 않으면 명령이 실패합니다. 대체 뷰가 테이블인 경우 Format-Table사용합니다. 대체 뷰가 목록이나 테이블이 아닌 경우 Format-Custom사용합니다.