다음을 통해 공유

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

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

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

  • EnumOnly: 컬렉션에 있는 개체의 속성을 표시합니다.
  • CoreOnly: 컬렉션 개체의 속성을 표시합니다.
  • 둘 다: 컬렉션 개체의 속성과 컬렉션에 있는 개체의 속성을 표시합니다.
형식: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 매개 변수의 값은 새 계산 속성일 수 있습니다. 계산된 속성을 만들려면 해시 테이블을 사용합니다. 이 매개 변수에 허용되는 값은 다음과 같습니다.

  • 이름(또는 레이블) <문자열>
  • 식 <문자열> 또는 <스크립트 블록>
  • FormatString <문자열>
형식:Object
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-InputObject

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

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

-Property

표시에 표시되는 개체 속성과 표시되는 순서를 지정합니다. 와일드카드가 허용됩니다.

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

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

  • 식 <문자열> 또는 <스크립트 블록>
  • FormatString <문자열>
형식: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

모든 개체를 Format-Wide파이프할 수 있습니다.

출력

Microsoft.PowerShell.Commands.Internal.Format

Format-Wide 테이블을 나타내는 형식 개체를 반환합니다.

참고

기본 제공 별칭인 fwFormat-Wide 참조할 수도 있습니다. 자세한 내용은 about_Aliases참조하세요.

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

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

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