다음을 통해 공유

Format-Wide

  • 참조
모듈:
Microsoft.PowerShell.Utility

개체를 각 개체의 속성 하나만 표시하는 넓은 테이블로 서식을 지정합니다.

구문

Format-Wide
      [[-Property] <Object>]
      [-AutoSize]
      [-Column <int>]
      [-GroupBy <Object>]
      [-View <string>]
       [-ShowError]
      [-DisplayError]
      [-Force]
      [-Expand <string>]
      [-InputObject <psobject>] 
      [<CommonParameters>]

Description

Format-Wide cmdlet은 각 개체의 속성을 하나만 표시하는 넓은 테이블로 개체의 서식을 지정합니다. 속성 매개 변수를 사용하여 표시되는 속성을 확인할 수 있습니다.

예제

예제 1: 현재 디렉터리에 있는 파일의 이름 서식 지정

이 명령은 화면의 세 열에 있는 현재 디렉터리에 있는 파일의 이름을 표시합니다.

Get-ChildItem | Format-Wide -Column 3

Get-ChildItem cmdlet은 디렉터리의 각 파일을 나타내는 개체를 가져옵니다. 파이프라인 연산자(|)는 파이프라인을 통해 파일 개체를 Format-Wide전달하여 출력에 맞게 형식을 지정합니다. Column 매개 변수는 열 수를 지정합니다.

예제 2: 레지스트리 키의 이름 서식 지정

이 명령은 HKEY_CURRENT_USER\Software\Microsoft 키에 레지스트리 키의 이름을 표시합니다.

Get-ChildItem HKCU:\software\microsoft | Format-Wide -Property pschildname -AutoSize

Get-ChildItem cmdlet은 키를 나타내는 개체를 가져옵니다. 경로는 PowerShell 레지스트리 공급자가 노출한 드라이브 중 하나인 HKCU:에 해당하며, 그 뒤에 키 경로가 옵니다. 파이프라인 연산자(|)는 파이프라인을 통해 레지스트리 키 개체를 Format-Wide전달하여 출력에 맞게 형식을 지정합니다. Property 매개 변수는 속성의 이름을 지정하고 AutoSize 매개 변수는 가독성을 위해 열을 조정합니다.

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

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

PS /> Get-Date | Format-Wide { $_ / $null } -DisplayError


#ERR

PS /> Get-Date | Format-Wide { $_ / $null } -ShowError


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

매개 변수

-AutoSize

데이터 너비에 따라 열 크기와 열 수를 조정합니다. 기본적으로 열 크기와 숫자는 뷰에 의해 결정됩니다. 동일한 명령에서 AutoSize 및 Column 매개 변수를 사용할 수 없습니다.

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

-Column

디스플레이의 열(칼럼) 수를 지정합니다. 동일한 명령에서 AutoSize 및 Column 매개 변수를 사용할 수 없습니다.

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

-DisplayError

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

형식: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:EnumOnly
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Force

이 cmdlet은 변경 내용이 보안을 손상시키지 않도록 명령이 성공하지 못하도록 하는 제한을 재정의한다는 것을 나타냅니다. 예를 들어, 강제는 읽기 전용 속성을 재정의하거나, 디렉터리를 생성하여 파일 경로를 완성할 수 있지만, 파일 권한을 변경하려고 시도하지는 않습니다.

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

-GroupBy

공유 속성 또는 값에 따라 그룹의 출력 형식을 지정합니다. 출력의 식 또는 속성을 입력합니다. GroupBy 매개 변수는 개체가 정렬되어 있기를 기대합니다. Format-Wide 사용하여 개체를 그룹화하기 전에 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 매개 변수의 값은 새 계산 속성일 수 있습니다. 계산된 속성은 스크립트 블록 또는 해시 테이블일 수 있습니다. 유효한 키-값 쌍은 다음과 같습니다.

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

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

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

-ShowError

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

형식: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-Wide에 대해 다음과 같은 별칭이 포함되어 있습니다.

  • 모든 플랫폼:
    • fw

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

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