다음을 통해 공유

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 매개 변수는 개체가 정렬되어 있을 것으로 예상합니다. Format-List 사용하여 개체를 그룹화하기 전에 Sort-Object 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은 목록을 나타내는 형식 개체를 반환합니다.

참고

Windows PowerShell에는 다음을 포함한 Format-List의 별칭이 있습니다.

  • fl

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

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

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

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

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

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

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

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

    • 래퍼 유형은 다음과 같습니다.