Dela via

Format-Custom

  • Referens
Modul:
Microsoft.PowerShell.Utility

Använder en anpassad vy för att formatera utdata.

Syntax

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

Description

Cmdleten Format-Custom formaterar utdata från ett kommando enligt definitionen i en alternativ vy. Format-Custom är utformat för att visa vyer som inte bara är tabeller eller bara listor. Du kan använda vyerna som definierats i *-formatet. PS1XML-filer i PowerShell-katalogen, eller så kan du skapa egna vyer i nya PS1XML-filer och använda cmdleten Update-FormatData för att lägga till dem i PowerShell.

Exempel

Exempel 1: Formatera utdata med en anpassad vy

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

Det här kommandot formaterar information om cmdleten Start-Transcript i det format som definieras av MyView-vyn, en anpassad vy som skapats av användaren. Om du vill köra det här kommandot måste du först skapa en ny PS1XML-fil, definiera vyn MyView och sedan använda kommandot Update-FormatData för att lägga till PS1XML-filen i PowerShell.

Exempel 2: Formatera utdata med standardvyn

Get-Process Winlogon | Format-Custom

Det här kommandot formaterar information om Winlogon-processen i en alternativ anpassad vy. Eftersom kommandot inte använder parametern View använder Format-Custom en anpassad standardvy för att formatera data.

Exempel 3: Felsöka formatfel

Följande exempel visar resultatet av att lägga till parametrarna DisplayError eller ShowError med ett uttryck.

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

Parametrar

-Depth

Anger antalet kolumner i visningen.

Typ:Int32
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-DisplayError

Visar fel på kommandoraden. Den här parametern används sällan, men kan användas som felsökningshjälp när du formaterar uttryck i ett Format-Custom kommando och uttrycken inte verkar fungera.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Expand

Formaterar samlingsobjektet samt objekten i samlingen. Den här parametern är utformad för att formatera objekt som stöder gränssnittet ICollection (System.Collections). Standardvärdet är EnumOnly.

Giltiga värden är:

  • EnumOnly: Visar egenskaperna för objekten i samlingen.
  • CoreOnly: Visar egenskaperna för samlingsobjektet.
  • Båda: Visar egenskaperna för samlingsobjektet och egenskaperna för objekt i samlingen.
Typ:String
Godkända värden:CoreOnly, EnumOnly, Both
Position:Named
Standardvärde:EnumOnly
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Force

Dirigerar cmdleten till att visa all felinformation. Använd med parametrarna DisplayError eller ShowError. När ett felobjekt skrivs till fel- eller visningsströmmar visas som standard endast en del av felinformationen.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-GroupBy

Formaterar utdata i grupper baserat på en delad egenskap eller ett delat värde. Ange ett uttryck eller en egenskap för utdata.

Värdet för parametern GroupBy kan vara en ny beräknad egenskap. Om du vill skapa en beräknad egenskap använder du en hash-tabell. Giltiga nycklar är:

  • Namn (eller etikett) <sträng>
  • Uttryck <sträng> eller <skriptblock>
  • FormatString <sträng>
Typ:Object
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-InputObject

Anger vilka objekt som ska formateras. Ange en variabel som innehåller objekten eller skriv ett kommando eller uttryck som hämtar objekten.

Typ:PSObject
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Property

Anger de objektegenskaper som visas i visningen och i vilken ordning de visas. Jokertecken tillåts.

Om du utelämnar den här parametern beror egenskaperna som visas i visningen på det objekt som visas. Parameternamnet ("Egenskap") är valfritt. Du kan inte använda parametrarna Property och View i samma kommando.

Värdet för egenskapsparametern kan vara en ny beräknad egenskap. Om du vill skapa en beräknad egenskap använder du en hash-tabell. Giltiga nycklar är:

  • Uttryck <sträng> eller <skriptblock>
  • Djup <int32>
Typ:Object[]
Position:0
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:True

-ShowError

Skickar fel via pipelinen. Den här parametern används sällan, men kan användas som felsökningshjälp när du formaterar uttryck i ett Format-Custom kommando och uttrycken inte verkar fungera.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-View

Anger namnet på ett alternativt format eller en "vy". Om du utelämnar den här parametern använder Format-Custom en anpassad standardvy. Du kan inte använda parametrarna Property och View i samma kommando.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Indata

PSObject

Du kan skicka valfritt objekt till Format-Custom.

Utdata

Microsoft.PowerShell.Commands.Internal.Format

Format-Custom returnerar formatobjekten som representerar visningen.

Kommentarer

Format-Custom är utformat för att visa vyer som inte bara är tabeller eller bara listor. Om du vill visa en alternativ tabellvy använder du Format-Table. Om du vill visa en alternativ listvy använder du Format-List.

Du kan också referera till Format-Custom med dess inbyggda alias, "fc". Mer information finns i about_Aliases.

Parametern GroupBy förutsätter att objekten sorteras. Innan du använder Format-Custom för att gruppera objekten använder du Sort-Object för att sortera dem.