다음을 통해 공유


Format-List

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

구문

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

Description

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

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

예제

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

Get-Service | Format-List

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

예제 2: PS1XML 파일 서식 지정

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

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

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

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

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

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

Get-Process | Format-List -Property Name, BasePriority, PriorityClass

cmdlet을 Get-Process 사용하여 각 프로세스를 나타내는 개체를 가져옵니다. 파이프라인 연산자(|)는 파이프라인을 통해 프로세스 개체를 전달합니다 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 매개 변수의 값은 새 계산 속성일 수 있습니다. 계산된 속성은 스크립트 블록 또는 해시 테이블일 수 있습니다. 유효한 키-값 쌍은 다음과 같습니다.

  • 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의 출력 기능 및 동사(cmdlet)를 포함하는 Out cmdlet( Out 예: Out-Host 또는 Out-File.)에 의해 표시됩니다.

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

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

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

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

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