Format-Wide
개체의 형식을 각 개체 속성을 하나만 표시하는 넓은 표로 지정합니다.
구문
Format-Wide [[-Property] <Object>] [-AutoSize] [-Column <int>] [-DisplayError] [-Expand <string>] [-Force] [-GroupBy <Object>] [-InputObject <psobject>] [-ShowError] [-View <string>] [<CommonParameters>]
설명
Format-Wide cmdlet은 개체의 형식을 각 개체 속성을 하나만 표시하는 넓은 표로 지정합니다. Property 매개 변수를 사용하여 표시되는 속성을 결정할 수 있습니다.
매개 변수
-AutoSize
데이터의 너비에 따라 열 크기 및 열 수를 조정합니다. 기본적으로 열 크기 및 수는 보기에 의해 결정됩니다. AutoSize 및 Column 매개 변수를 같은 명령에 사용할 수 없습니다.
필수 여부 |
false |
위치 |
named |
기본값 |
|
파이프라인 입력 적용 여부 |
false |
와일드카드 문자 적용 여부 |
false |
-Column <int>
표시에서 열의 개수를 지정합니다. AutoSize 및 Column 매개 변수를 같은 명령에 사용할 수 없습니다.
필수 여부 |
false |
위치 |
named |
기본값 |
|
파이프라인 입력 적용 여부 |
false |
와일드카드 문자 적용 여부 |
false |
-DisplayError
명령줄에 오류를 표시합니다.
필수 여부 |
false |
위치 |
named |
기본값 |
|
파이프라인 입력 적용 여부 |
false |
와일드카드 문자 적용 여부 |
false |
-Expand <string>
컬렉션의 개체와 함께 컬렉션 개체의 형식을 지정합니다. 이 매개 변수는 ICollection (System.Collections) 인터페이스를 지원하는 개체의 형식을 지정하도록 디자인되었습니다. 기본값은 EnumOnly입니다.
유효한 값은 다음과 같습니다.
-- EnumOnly: 컬렉션에 있는 개체의 속성을 표시합니다.
-- CoreOnly: 컬렉션 개체의 속성을 표시합니다.
-- Both: 컬렉션 개체의 속성 및 컬렉션에 있는 개체의 속성을 표시합니다.
필수 여부 |
false |
위치 |
named |
기본값 |
|
파이프라인 입력 적용 여부 |
false |
와일드카드 문자 적용 여부 |
false |
-Force
명령이 완료되지 못하도록 방해하는 제한 사항을 보안이 손상되지 않는 범위에서 재정의합니다. 예를 들어 Force는 읽기 전용 특성을 재정의하거나, 디렉터리를 만들어 파일 경로를 완성할 수 있지만 파일 사용 권한을 변경하지는 못합니다.
필수 여부 |
false |
위치 |
named |
기본값 |
|
파이프라인 입력 적용 여부 |
false |
와일드카드 문자 적용 여부 |
false |
-GroupBy <Object>
공유 속성이나 값에 따라 그룹에서 출력의 형식을 지정합니다. 출력의 식이나 속성을 입력합니다.
GroupBy 매개 변수의 값은 새로 계산된 속성일 수 있습니다. 계산된 속성을 만들려면 해시 테이블을 사용합니다. 유효한 키는 다음과 같습니다.
-- Name(또는 Label) <string>
-- Expression <string> 또는 <script block>
-- FormatString <string>
필수 여부 |
false |
위치 |
named |
기본값 |
|
파이프라인 입력 적용 여부 |
false |
와일드카드 문자 적용 여부 |
false |
-InputObject <psobject>
형식을 지정할 개체를 지정합니다. 개체가 포함된 변수를 입력하거나 개체를 가져오는 명령 또는 식을 입력하십시오.
필수 여부 |
false |
위치 |
named |
기본값 |
|
파이프라인 입력 적용 여부 |
true (ByValue) |
와일드카드 문자 적용 여부 |
false |
-Property <Object>
표시에 나타나는 개체 속성 및 나타나는 순서를 지정합니다. 와일드카드를 사용할 수 있습니다.
이 매개 변수를 생략하면 표시에 나타나는 속성이 표시되는 개체에 따라 달라집니다. 매개 변수 이름("Property")은 선택 사항입니다. Property 및 View 매개 변수를 같은 명령에 사용할 수 없습니다.
Property 매개 변수의 값은 새로 계산된 속성일 수 있습니다. 계산된 속성을 만들려면 해시 테이블을 사용합니다. 유효한 키는 다음과 같습니다.
-- Expression <string> 또는 <script block>
-- FormatString <string>
필수 여부 |
false |
위치 |
1 |
기본값 |
|
파이프라인 입력 적용 여부 |
false |
와일드카드 문자 적용 여부 |
false |
-ShowError
파이프라인을 통해 오류를 보냅니다.
필수 여부 |
false |
위치 |
named |
기본값 |
|
파이프라인 입력 적용 여부 |
false |
와일드카드 문자 적용 여부 |
false |
-View <string>
대체 테이블 형식 또는 "보기"의 이름을 지정합니다. Property 및 View 매개 변수를 같은 명령에 사용할 수 없습니다.
필수 여부 |
false |
위치 |
named |
기본값 |
|
파이프라인 입력 적용 여부 |
false |
와일드카드 문자 적용 여부 |
false |
<CommonParameters>
이 cmdlet은 -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, -OutVariable 등의 일반 매개 변수를 지원합니다. 자세한 내용은 about_commonparameters.
입력 및 출력
입력 유형은 cmdlet으로 파이프할 수 있는 개체의 유형입니다. 반환 유형은 cmdlet에서 반환되는 개체의 유형입니다.
입력 |
System.Management.Automation.PSObject 임의의 개체를 Format-Wide로 파이프할 수 있습니다. |
출력 |
Microsoft.PowerShell.Commands.Internal.Format Format-Wide는 테이블을 나타내는 형식 개체를 반환합니다. |
참고
또한 해당 기본 제공 별칭("fw")으로 Format-Wide를 참조할 수 있습니다. 자세한 내용은 about_Aliases를 참조하십시오.
GroupBy 매개 변수는 개체가 정렬된 것으로 가정합니다. Format-Custom을 사용하여 개체를 그룹화하기 전에 Sort-Object를 사용하여 개체를 정렬하십시오.
-View 매개 변수를 사용하면 표에 대해 다른 형식을 지정할 수 있습니다. Windows PowerShell 디렉터리에서 *.format.PS1XML 파일에 정의된 보기를 사용하거나 새로운 PS1XML 파일에서 자신만의 보기를 만들고 Update-FormatData cmdlet을 사용하여 Windows PowerShell에 포함할 수 있습니다.
View 매개 변수에 대한 다른 보기는 테이블 형식을 사용해야 합니다. 그렇지 않으면 명령이 실패합니다. 다른 보기가 목록이라면 Format-List를 사용하십시오. 대체 보기가 목록이나 테이블이 아니라면 Format-Custom을 사용하십시오.
예 1
C:\PS>get-childitem | format-wide -column 3
설명
-----------
이 명령은 화면 전체의 세 열에 현재 디렉터리의 파일 이름을 표시합니다. Get-ChildItem cmdlet은 디렉터리의 각 파일을 나타내는 개체를 가져옵니다. 파이프라인 연산자(|)는 파이프라인을 통해 Format-Wide로 파일 개체를 보내고 Format-Wide는 출력을 위해 이 개체 형식을 지정합니다. Column 매개 변수는 열의 개수를 지정합니다.
예 2
C:\PS>get-childitem HKCU:\software\microsoft | format-wide -property pschildname -autosize
설명
-----------
이 명령은 HKEY_CURRENT_USER\Software\Microsoft 키에 레지스트리 키의 이름을 표시합니다. Get-ChildItem cmdlet은 키를 나타내는 개체를 가져옵니다. 경로는 Windows PowerShell Registry 공급자에서 제공하는 드라이브 중 하나인 "HKCU:"로 지정되며 그 다음에 키 경로가 표시됩니다. 파이프라인 연산자(|)는 파이프라인을 통해 Format-Wide로 레지스트리 키를 전달하고 Format-Wide는 출력을 위해 이 개체 형식을 지정합니다. Property 매개 변수는 속성 이름을 지정하고 AutoSize 매개 변수는 읽기 쉽도록 열을 조정합니다.