다음을 통해 공유

Format-List

  • 참조
모듈:
Microsoft.PowerShell.Utility

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

구문

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

Description

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

테이블보다 목록의 각 항목에 더 많은 공간을 사용할 수 있으므로 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

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

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

-Force

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

특정 .NET 형식의 서식을 지정할 때도 필요합니다. 자세한 내용은 참고 섹션을 참조하세요.

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

-GroupBy

공유 속성 또는 값을 기반으로 그룹의 출력을 지정합니다. 출력의 식 또는 속성을 입력합니다. GroupBy 매개 변수는 개체가 정렬되어 있는 것을 기대합니다. Sort-Object 사용하여 개체를 그룹화하기 전에 Format-List cmdlet을 사용합니다.

GroupBy 매개 변수의 값은 새 계산 속성일 수 있습니다. 계산된 속성은 스크립트 블록 또는 해시 테이블일 수 있습니다. 유효한 키-값 쌍은 다음과 같습니다.

  • Name(또는 Label) - <string>
  • Expression - <string> 또는 <script block>
  • FormatString - <string>

자세한 내용은 about_Calculated_Properties참조하세요.

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

-InputObject

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

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

-Property

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

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

Property 매개 변수의 값은 새 계산 속성일 수 있습니다. 계산된 속성은 스크립트 블록 또는 해시 테이블일 수 있습니다. 유효한 키-값 쌍은 다음과 같습니다.

  • Name(또는 Label) - <string>
  • Expression - <string> 또는 <script block>
  • FormatString - <string>

자세한 내용은 about_Calculated_Properties참조하세요.

형식: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

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

출력

Microsoft.PowerShell.Commands.Internal.Format

이 cmdlet은 목록을 나타내는 형식 개체를 반환합니다.

참고

PowerShell에는 다음과 같은 Format-List의 별칭이 포함되어 있습니다.

  • 모든 플랫폼:
    • fl

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

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

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

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

Format-List 매개 변수와 함께 사용하려면 다음 조건 중에서 Force 매개 변수를 포함해야 합니다.

  • 입력 개체는 ToString() 메서드를 사용하여 대역 외 형식으로 지정됩니다. 이는 [string], [int]등과 같은 기본 제공 숫자 형식의 상위 집합인 [long] 및 .NET 기본 형식에 적용됩니다.

  • 입력 개체에는 공용 속성이 없습니다.

  • 입력 개체는 PowerShell이 성공 출력 스트림 이외의 출력 스트림에 사용하는 래퍼 유형의 인스턴스입니다. 이는 이러한 래퍼 형식이 성공 출력 스트림으로 전송되는 경우에만 해당하며, 먼저 ErrorVariable 등과 같은 일반적인 매개변수를 통해 캡처하거나 *>&1와 같은 리디렉션을 사용해야 합니다.