Share via

Format-Wide

  • 참조
모듈:
Microsoft.PowerShell.Utility

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

Syntax

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

Description

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

예제

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

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

Get-ChildItem | Format-Wide -Column 3

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

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

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

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

cmdlet은 Get-ChildItem 키를 나타내는 개체를 가져옵니다. 경로는 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

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Column

디스플레이의 열 수를 지정합니다. 동일한 명령에서는 자동 크기 조정 및 열 매개 변수를 사용할 수 없습니다.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisplayError

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Expand

컬렉션 개체와 컬렉션의 개체에 서식을 지정합니다. 이 매개 변수는 System.Collections.ICollection 인터페이스를 지원하는 개체의 서식을 지정하도록 설계되었습니다. 기본값은 EnumOnly입니다.

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

  • EnumOnly: 컬렉션에 있는 개체의 속성을 표시합니다.
  • CoreOnly: 컬렉션 개체의 속성을 표시합니다.
  • Both: 컬렉션 개체의 속성과 컬렉션에 있는 개체의 속성을 표시합니다.
Type:String
Accepted values:CoreOnly, EnumOnly, Both
Position:Named
Default value:EnumOnly
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-GroupBy

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

GroupBy 매개 변수의 값은 새 계산 속성일 수 있습니다. 계산된 속성은 스크립트 블록 또는 해시 테이블일 수 있습니다. 유효한 키-값 쌍은 다음과 같습니다.

  • Name (또는 Label) - <string>
  • Expression - <string> 또는 <script block>
  • FormatString - <string>

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

Type:Object
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

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

Type:PSObject
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Property

디스플레이에 표시되는 개체 속성을 지정합니다. 야생카드 허용됩니다.

이 매개 변수를 생략하면 표시에 표시되는 속성은 표시되는 개체에 따라 달라집니다. 매개 변수 이름 속성 은 선택 사항입니다. 동일한 명령에서 속성 및 보기 매개 변수를 사용할 수 없습니다.

Property 매개 변수의 값은 새 계산 속성일 수 있습니다. 계산된 속성은 스크립트 블록 또는 해시 테이블일 수 있습니다. 유효한 키-값 쌍은 다음과 같습니다.

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

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

Type:Object
Position:0
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-ShowError

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-View

대체 테이블 형식 또는 뷰의 이름을 지정합니다. 동일한 명령에서 속성 및 보기 매개 변수를 사용할 수 없습니다.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

입력

PSObject

모든 개체를 이 cmdlet으로 파이프할 수 있습니다.

출력

Microsoft.PowerShell.Commands.Internal.Format

이 cmdlet은 테이블을 나타내는 형식 개체를 반환합니다.

참고

PowerShell에는 다음 별칭이 포함됩니다.Format-Wide

  • 모든 플랫폼:
    • fw

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

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

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