Format-List

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

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

목록에서는 표보다 각 항목에 대해 사용할 수 있는 공간이 많으므로 Windows PowerShell은 목록에서 개체의 속성을 더 많이 표시하고 속성 값도 덜 잘립니다.

-DisplayError

명령줄에 오류를 표시합니다.

필수 여부	false
위치	named
기본값
파이프라인 입력 적용 여부	false
와일드카드 문자 적용 여부	false

-Expand <string>

컬렉션의 개체와 함께 컬렉션 개체의 형식을 지정합니다. 이 매개 변수는 ICollection (System.Collections) 인터페이스를 지원하는 개체의 형식을 지정하도록 디자인되었습니다. 기본값은 EnumOnly입니다.

유효한 값은 다음과 같습니다.

-- EnumOnly: 컬렉션에 있는 개체의 속성을 표시합니다.

-- CoreOnly: 컬렉션 개체의 속성을 표시합니다.

-- Both: 컬렉션 개체의 속성 및 컬렉션에 있는 개체의 속성을 표시합니다.

필수 여부	false
위치	named
기본값
파이프라인 입력 적용 여부	false
와일드카드 문자 적용 여부	false

-Force

cmdlet에 모든 오류 정보를 표시하도록 지시합니다. DisplayError 또는 ShowError 매개 변수와 함께 사용합니다. 기본적으로 오류 개체를 오류 또는 표시 스트림에 쓸 때 일부 오류 정보만 표시됩니다.

필수 여부	false
위치	named
기본값
파이프라인 입력 적용 여부	false
와일드카드 문자 적용 여부	false

-GroupBy <Object>

공유 속성이나 값에 따라 그룹에서 출력의 형식을 지정합니다. 출력의 식이나 속성을 입력합니다.

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

-- Name(또는 Label) <string>

-- Expression <string> 또는 <script block>

-- FormatString <string>

필수 여부	false
위치	named
기본값
파이프라인 입력 적용 여부	false
와일드카드 문자 적용 여부	false

-InputObject <psobject>

형식을 지정할 개체를 지정합니다. 개체가 포함된 변수를 입력하거나 개체를 가져오는 명령 또는 식을 입력하십시오.

필수 여부	false
위치	named
기본값
파이프라인 입력 적용 여부	true (ByValue)
와일드카드 문자 적용 여부	false

-Property <Object[]>

표시에 나타나는 개체 속성 및 나타나는 순서를 지정합니다. 와일드카드를 사용할 수 있습니다.

이 매개 변수를 생략하면 표시에 나타나는 속성이 표시되는 개체에 따라 달라집니다. 매개 변수 이름("Property")은 선택 사항입니다. Property 및 View 매개 변수를 같은 명령에 사용할 수 없습니다.

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

-- Name(또는 Label) <string>

-- Expression <string> 또는 <script block>

-- FormatString <string>

필수 여부	false
위치	1
기본값
파이프라인 입력 적용 여부	false
와일드카드 문자 적용 여부	false

-ShowError

파이프라인을 통해 오류를 보냅니다.

필수 여부	false
위치	named
기본값
파이프라인 입력 적용 여부	false
와일드카드 문자 적용 여부	false

-View <string>

대체 목록 형식 또는 "보기"의 이름을 지정합니다. Property 및 View 매개 변수를 같은 명령에 사용할 수 없습니다.

필수 여부	false
위치	named
기본값
파이프라인 입력 적용 여부	false
와일드카드 문자 적용 여부	false

<CommonParameters>

이 cmdlet은 -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, -OutVariable 등의 일반 매개 변수를 지원합니다. 자세한 내용은 about_Commonparameters.

입력 유형은 cmdlet으로 파이프할 수 있는 개체의 유형입니다. 반환 유형은 cmdlet에서 반환되는 개체의 유형입니다.

입력

System.Management.Automation.PSObject

임의의 개체를 Format-List로 파이프할 수 있습니다.

출력

Microsoft.PowerShell.Commands.Internal.Format

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

또한 해당 기본 제공 별칭("FL")으로 Format-List를 참조할 수 있습니다. 자세한 내용은 about_Aliases를 참조하십시오.

Format-List와 같은 형식 cmdlet은 표시할 데이터를 정렬하지만 표시하지는 않습니다. 데이터는 Windows PowerShell의 출력 기능 및 Out-Host, Out-File, Out-Printer와 같은 Out 동사를 포함하는 cmdlet(Out cmdlet)을 통해 표시됩니다.

Cmdlet 형식을 사용하지 않으면 Windows PowerShell에서 표시되는 각 개체에 대해 기본 형식을 적용합니다.

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

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

View 매개 변수에 대한 대체 보기는 목록 형식을 사용해야 합니다. 그렇지 않으면 명령이 실패합니다. 대체 보기가 테이블이라면 Format-Table을 사용하십시오. 대체 보기가 목록이나 테이블이 아니라면 Format-Custom을 사용하십시오.

C:\PS>get-service | format-list

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

C:\PS>$a = get-childitem $pshome\*.ps1xml

설명
-----------
이들 명령은 Windows PowerShell 디렉터리에 있는 PS1XML 파일에 대한 정보를 목록으로 표시합니다. 첫 번째 명령은 파일을 나타내는 개체를 가져와 $a 변수에 저장합니다. 두 번째 명령은 Format-List를 사용하여 $a에 저장된 개체에 대한 정보의 형식을 지정합니다. 이 명령은 InputObject 매개 변수를 사용하여 변수를 Format-List로 전달합니다. 그러면 이 cmdlet은 형식이 지정된 출력을 표시할 수 있도록 기본 출력 cmdlet으로 보냅니다.

C:\PS>get-process | format-list -property name, basepriority, priorityclass

설명
-----------
이 명령은 컴퓨터 각 프로세스의 이름, 기본 우선 순위 및 우선 순위 클래스를 표시하고 Get-Process cmdlet을 사용하여 각 프로세스를 나타내는 개체를 가져옵니다. 파이프라인 연산자(|)는 파이프라인을 통해 Format-List로 프로세스 개체를 전달합니다. Format-List는 프로세스 형식을 지정된 속성의 목록으로 지정합니다. "Property" 매개 변수 이름은 선택 사항이므로 생략할 수 있습니다.

C:\PS>get-process winlogon | format-list -property *

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