다음을 통해 공유


Format-Custom

사용자 지정된 보기를 사용하여 출력 형식을 지정합니다.

구문

Format-Custom [[-Property] <Object[]>] [-Depth <int>] [-DisplayError] [-Expand <string>] [-Force] [-GroupBy <Object>] [-InputObject <psobject>] [-ShowError] [-View <string>] [<CommonParameters>]

설명

Format-Custom cmdlet은 대체 보기에 정의된 대로 명령의 출력 형식을 지정합니다. Format-Custom은 단순한 테이블이나 목록이 아닌 보기를 표시하도록 설계되었습니다. Windows PowerShell 디렉터리에서 *.format.PS1XML 파일에 정의된 보기를 사용하거나 새로운 PS1XML 파일에서 자신만의 보기를 만들고 Update-FormatData cmdlet을 사용하여 Windows PowerShell에 추가할 수 있습니다.

매개 변수

-Depth <int>

표시에서 열의 개수를 지정합니다.

필수 여부

false

위치

named

기본값

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

-DisplayError

명령줄에 오류를 표시합니다.

필수 여부

false

위치

named

기본값

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

-Expand <string>

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

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

-- EnumOnly: 컬렉션에 있는 개체의 속성을 표시합니다.

-- CoreOnly: 컬렉션 개체의 속성을 표시합니다.

-- Both: 컬렉션 개체의 속성 및 컬렉션에 있는 개체의 속성을 표시합니다.

필수 여부

false

위치

named

기본값

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

-Force

cmdlet에 모든 오류 정보를 표시하도록 지시합니다. DisplayError 또는 ShowError 매개 변수와 함께 사용합니다. 기본적으로 오류 개체를 오류 또는 표시 스트림에 쓸 때 일부 오류 정보만 표시됩니다.

필수 여부

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>

-- Depth <int32>

필수 여부

false

위치

1

기본값

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

-ShowError

파이프라인을 통해 오류를 보냅니다.

필수 여부

false

위치

named

기본값

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

-View <string>

대체 형식 또는 "보기"의 이름을 지정합니다. 이 매개 변수를 생략하면 Format-Custom이 기본 사용자 지정 보기를 사용합니다. Property 및 View 매개 변수를 같은 명령에 사용할 수 없습니다.

필수 여부

false

위치

named

기본값

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

<CommonParameters>

이 cmdlet은 -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, -OutVariable 등의 일반 매개 변수를 지원합니다. 자세한 내용은 about_commonparameters.

입력 및 출력

입력 유형은 cmdlet으로 파이프할 수 있는 개체의 유형입니다. 반환 유형은 cmdlet에서 반환되는 개체의 유형입니다.

입력

System.Management.Automation.PSObject

임의의 개체를 Format-Custom으로 파이프할 수 있습니다.

출력

Microsoft.PowerShell.Commands.Internal.Format

Format-Custom은 표시를 나타내는 형식 개체를 반환합니다.

참고

Format-Custom은 단순한 테이블이나 목록이 아닌 보기를 표시하도록 설계되었습니다. 대체 테이블 보기를 표시하려면 Format-Table을 사용하십시오. 대체 목록 보기를 표시하려면 Format-List를 사용하십시오.

또한 해당 기본 제공 별칭("fc")으로 Format-Custom을 참조할 수 있습니다. 자세한 내용은 about_Aliases를 참조하십시오.

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

예 1

C:\PS>get-command start-transcript | format-custom -view MyView

설명
-----------
이 명령은 Start-Transcript cmdlet에 대한 정보 형식을 MyView 보기(사용자가 만든 사용자 지정 보기)에서 정의한 형식으로 지정합니다. 이 명령을 제대로 실행하려면 먼저 새 PS1XML 파일을 만들고, MyView 보기를 정의한 다음, Update-FormatData 명령을 사용하여 PS1XML 파일을 Windows PowerShell에 추가해야 합니다.





예 2

C:\PS>get-process Winlogon | format-custom

설명
-----------
이 명령은 Winlogon 프로세스에 대한 정보의 형식을 다른 사용자 지정 보기로 지정합니다. 이 명령은 View 매개 변수를 사용하지 않으므로 Format-Custom이 기본 사용자 지정 보기를 사용하여 데이터의 형식을 지정합니다.