Format-Wide
개체를 각 개체의 속성 하나만 표시하는 넓은 테이블로 서식을 지정합니다.
구문
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 |
입력
모든 개체를 이 cmdlet으로 파이프할 수 있습니다.
출력
Microsoft.PowerShell.Commands.Internal.Format
이 cmdlet은 테이블을 나타내는 형식 개체를 반환합니다.
참고
Windows PowerShell에는 다음과 같은 Format-Wide
별칭이 포함되어 있습니다.
fw
View 매개 변수를 사용하면 테이블에 대한 대체 형식을 지정할 수 있습니다. PowerShell 디렉터리의 *.format.PS1XML
파일에 정의된 보기를 사용하거나 새 PS1XML 파일에서 고유한 보기를 만들고 Update-FormatData
cmdlet을 사용하여 PowerShell에 포함할 수 있습니다.
View 매개 변수의 대체 뷰는 테이블 형식을 사용해야 합니다. 그렇지 않으면 명령이 실패합니다. 대체 보기가 목록인 경우 Format-List
사용합니다. 대체 뷰가 목록이나 테이블이 아니면 Format-Custom
사용합니다.
관련 링크
PowerShell