다음을 통해 공유

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

형식: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사용합니다.