Format-Custom

  • Odwołanie
Moduł:
Microsoft.PowerShell.Utility

Używa dostosowanego widoku do formatowania danych wyjściowych.

Składnia

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

Opis

Polecenie Format-Custom cmdlet formatuje dane wyjściowe polecenia zgodnie z definicją w widoku alternatywnym. Format-Custom jest przeznaczony do wyświetlania widoków, które nie są tylko tabelami lub po prostu listami. Możesz użyć widoków zdefiniowanych w programie PowerShell lub utworzyć własne widoki w nowym format.ps1xml pliku i użyć Update-FormatData polecenia cmdlet , aby dodać je do programu PowerShell.

Przykłady

Przykład 1. Formatowanie danych wyjściowych za pomocą widoku niestandardowego

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

To polecenie formatuje informacje o Start-Transcript poleceniu cmdlet w formacie zdefiniowanym przez widok MyView, widok niestandardowy utworzony przez użytkownika. Aby pomyślnie uruchomić to polecenie, należy najpierw utworzyć nowy plik PS1XML, zdefiniować widok MyView , a następnie użyć Update-FormatData polecenia , aby dodać plik PS1XML do programu PowerShell.

Przykład 2. Formatowanie danych wyjściowych przy użyciu widoku domyślnego

Get-Process Winlogon | Format-Custom

To polecenie formatuje informacje o procesie Winlogon w alternatywnym dostosowanym widoku. Ponieważ polecenie nie używa parametru Widok, Format-Custom używa domyślnego widoku niestandardowego do formatowania danych.

Przykład 3. Rozwiązywanie problemów z błędami formatu

W poniższych przykładach pokazano wyniki dodawania parametrów DisplayError lub ShowError z wyrażeniem.

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

Parametry

-Depth

Określa liczbę kolumn na ekranie.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisplayError

Wyświetla błędy w wierszu polecenia. Ten parametr jest rzadko używany, ale może być używany jako pomoc debugowania podczas formatowania wyrażeń w Format-Custom poleceniu, a wyrażenia nie wydają się działać.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Expand

Formatuje obiekt kolekcji, a także obiekty w kolekcji. Ten parametr jest przeznaczony do formatowania obiektów obsługujących interfejs System.Collections.ICollection . Wartość domyślna to EnumOnly.

Prawidłowe wartości to:

  • EnumOnly: wyświetla właściwości obiektów w kolekcji.
  • CoreOnly: wyświetla właściwości obiektu kolekcji.
  • Oba: wyświetla właściwości obiektu kolekcji i obiektów w kolekcji.
Type:String
Accepted values:CoreOnly, EnumOnly, Both
Position:Named
Default value:EnumOnly
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

Przekierowuje polecenie cmdlet, aby wyświetlić wszystkie informacje o błędzie. Użyj z parametrami DisplayError lub ShowError . Domyślnie, gdy obiekt błędu jest zapisywany w strumieniach błędów lub wyświetlanych strumieni, wyświetlane są tylko niektóre informacje o błędzie.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-GroupBy

Formatuje dane wyjściowe w grupach na podstawie właściwości udostępnionej lub wartości. Wprowadź wyrażenie lub właściwość danych wyjściowych.

Wartość parametru GroupBy może być nową właściwością obliczeniową. Właściwość obliczeniowa może być blokiem skryptu lub tabelą skrótów. Prawidłowe pary klucz-wartość to:

  • Nazwa (lub etykieta) — <string>
  • Wyrażenie — <string> lub <script block>
  • Formatstring- <string>

Aby uzyskać więcej informacji, zobacz about_Calculated_Properties.

Type:Object
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Określa obiekty, które mają być sformatowane. Wprowadź zmienną zawierającą obiekty lub wpisz polecenie lub wyrażenie, które pobiera obiekty.

Type:PSObject
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Property

Określa właściwości obiektu wyświetlane na ekranie i kolejność ich wyświetlania. Dozwolone są symbole wieloznaczne.

Jeśli pominiesz ten parametr, właściwości wyświetlane na ekranie zależą od wyświetlanego obiektu. Właściwość nazwy parametru jest opcjonalna. Nie można użyć parametrów Właściwości i Wyświetl w tym samym poleceniu.

Wartość parametru Property może być nową właściwością obliczeniową. Właściwość obliczeniowa może być blokiem skryptu lub tabelą skrótów. Prawidłowe pary klucz-wartość to:

  • Wyrażenie — <string> lub <script block>
  • Głębokość- <int32>

Aby uzyskać więcej informacji, zobacz about_Calculated_Properties.

Type:Object[]
Position:0
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-ShowError

Wysyła błędy za pośrednictwem potoku. Ten parametr jest rzadko używany, ale może być używany jako pomoc debugowania podczas formatowania wyrażeń w Format-Custom poleceniu, a wyrażenia nie wydają się działać.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-View

Określa nazwę alternatywnego formatu lub widoku. W przypadku pominięcia tego parametru Format-Custom użyje domyślnego widoku niestandardowego. Nie można użyć parametrów Właściwości i Wyświetl w tym samym poleceniu.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Dane wejściowe

PSObject

Do tego polecenia cmdlet można przekazać dowolny obiekt.

Dane wyjściowe

Microsoft.PowerShell.Commands.Internal.Format

To polecenie cmdlet zwraca obiekty formatu reprezentujące wyświetlacz.

Uwagi

Program PowerShell zawiera następujące aliasy dla programu Format-Custom:

  • Wszystkie platformy:
    • fc

Format-Custom jest przeznaczony do wyświetlania widoków, które nie są tylko tabelami lub po prostu listami. Aby wyświetlić alternatywny widok tabeli, użyj polecenia Format-Table. Aby wyświetlić widok listy alternatywnej, użyj polecenia Format-List.

Parametr GroupBy zakłada, że obiekty są sortowane. Przed użyciem Format-Custom do grupowania obiektów użyj polecenia Sort-Object , aby je posortować.