개체의 형식을 각 개체 속성을 하나만 표시하는 넓은 표로 지정합니다.

구문

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 매개 변수는 읽기 쉽도록 열을 조정합니다.









목차