다음을 통해 공유

Format-Custom

  • 참조
모듈:
Microsoft.PowerShell.Utility

사용자 지정된 뷰를 사용하여 출력의 서식을 지정합니다.

구문

Format-Custom
      [[-Property] <Object[]>]
      [-Depth <Int32>]
      [-GroupBy <Object>]
      [-View <String>]
      [-ShowError]
      [-DisplayError]
      [-Force]
      [-Expand <String>]
      [-InputObject <PSObject>]
      [<CommonParameters>]

Description

cmdlet은 Format-Custom 대체 뷰에 정의된 대로 명령의 출력 형식을 지정합니다. Format-Custom 는 테이블 또는 목록만이 아닌 보기를 표시하도록 설계되었습니다. PowerShell에 정의된 보기를 사용하거나 새 파일에서 format.ps1xml 고유한 보기를 만들고 cmdlet을 Update-FormatData 사용하여 PowerShell에 추가할 수 있습니다.

예제

예제 1: 사용자 지정 보기를 사용하여 출력 서식 지정

Get-Command Start-Transcript | Format-Custom -View MyView

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

예제 2: 기본 보기를 사용하여 출력 서식 지정

Get-Process Winlogon | Format-Custom

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

예제 3: 형식 오류 문제 해결

다음 예제에서는 식을 사용하여 DisplayError 또는 ShowError 매개 변수를 추가한 결과를 보여 줍니다.

PC /> Get-Date | Format-Custom DayOfWeek,{ $_ / $null } -DisplayError

class DateTime
{
  DayOfWeek = Friday
   $_ / $null  = #ERR
}


PC /> Get-Date | Format-Custom DayOfWeek,{ $_ / $null } -ShowError

class DateTime
{
  DayOfWeek = Friday
   $_ / $null  =
}

Failed to evaluate expression " $_ / $null ".
+ CategoryInfo          : InvalidArgument: (12/21/2018 8:01:04 AM:PSObject) [], RuntimeException
+ FullyQualifiedErrorId : PSPropertyExpressionError

매개 변수

-Depth

디스플레이의 열 수를 지정합니다.

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

-DisplayError

명령줄에 오류를 표시합니다. 이 매개 변수는 거의 사용되지 않지만 명령에서 Format-Custom 식의 서식을 지정할 때 디버깅 보조로 사용할 수 있으며 식이 작동하지 않는 것처럼 보입니다.

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

-Expand

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

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

  • EnumOnly: 컬렉션에 있는 개체의 속성을 표시합니다.
  • CoreOnly: 컬렉션 개체의 속성을 표시합니다.
  • 둘 다: 컬렉션 개체의 속성과 컬렉션의 개체를 표시합니다.
형식:String
허용되는 값:CoreOnly, EnumOnly, Both
Position:Named
Default value:EnumOnly
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Force

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

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

-GroupBy

공유 속성 또는 값에 따라 그룹의 출력 형식을 지정합니다. 출력의 식 또는 속성을 입력합니다.

GroupBy 매개 변수의 값은 새 계산 속성일 수 있습니다. 계산된 속성은 스크립트 블록 또는 해시 테이블일 수 있습니다. 유효한 키-값 쌍은 다음과 같습니다.

  • 이름(또는 레이블) - <string>
  • 식 - <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 매개 변수의 값은 새 계산 속성일 수 있습니다. 계산된 속성은 스크립트 블록 또는 해시 테이블일 수 있습니다. 유효한 키-값 쌍은 다음과 같습니다.

  • 식 - <string> 또는 <script block>
  • 깊이- <int32>

자세한 내용은 about_Calculated_Properties 참조하세요.

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

-ShowError

파이프라인을 통해 오류를 보냅니다. 이 매개 변수는 거의 사용되지 않지만 명령에서 Format-Custom 식의 서식을 지정할 때 디버깅 보조로 사용할 수 있으며 식이 작동하지 않는 것처럼 보입니다.

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

-View

대체 형식 또는 뷰의 이름을 지정합니다. 이 매개 변수 Format-Custom 를 생략하면 기본 사용자 지정 보기를 사용합니다. 동일한 명령에서 속성 및 보기 매개 변수를 사용할 수 없습니다.

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

입력

PSObject

모든 개체를 이 cmdlet으로 파이프할 수 있습니다.

출력

Microsoft.PowerShell.Commands.Internal.Format

이 cmdlet은 디스플레이를 나타내는 서식 개체를 반환합니다.

참고

PowerShell에는 다음 별칭이 포함됩니다.Format-Custom

  • 모든 플랫폼:
    • fc

Format-Custom 는 테이블 또는 목록만이 아닌 보기를 표시하도록 설계되었습니다. 대체 테이블 뷰를 표시하려면 .를 사용합니다 Format-Table. 대체 목록 보기를 Format-List표시하려면 .

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