Format-Custom

  • Referencia
Modul:
Microsoft.PowerShell.Utility

Testre szabott nézetet használ a kimenet formázásához.

Syntax

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

Description

A Format-Custom parancsmag egy parancs kimenetét egy másik nézetben definiált módon formázja. Format-Custom Olyan nézetek megjelenítésére szolgál, amelyek nem csak táblák vagy csak listák. Használhatja a PowerShellben definiált nézeteket, vagy létrehozhat saját nézeteket egy új format.ps1xml fájlban, és a Update-FormatData parancsmaggal hozzáadhatja őket a PowerShellhez.

Példák

1. példa: Kimenet formázása egyéni nézettel

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

Ez a parancs formázza a Start-Transcript parancsmag adatait a MyView nézet által meghatározott formátumban, a felhasználó által létrehozott egyéni nézetben. A parancs sikeres futtatásához először létre kell hoznia egy új PS1XML-fájlt, meg kell határoznia a MyView nézetet, majd a Update-FormatData paranccsal fel kell vennie a PS1XML-fájlt a PowerShellbe.

2. példa: Kimenet formázása az alapértelmezett nézettel

Get-Process Winlogon | Format-Custom

Ez a parancs egy másik testreszabott nézetben formázja a Winlogon-folyamat adatait. Mivel a parancs nem használja a Nézet paramétert, Format-Custom az adatok formázásához alapértelmezett egyéni nézetet használ.

3. példa: Formátumhibák elhárítása

Az alábbi példák a DisplayError vagy ShowError paraméterek kifejezéssel való hozzáadásának eredményeit mutatják be.

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

Paraméterek

-Depth

A megjelenítendő oszlopok számát adja meg.

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

-DisplayError

Hibák megjelenítése a parancssorban. Ezt a paramétert ritkán használják, de hibakeresési segédként is használható, ha kifejezéseket formáz egy Format-Custom parancsban, és úgy tűnik, hogy a kifejezések nem működnek.

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

-Expand

Formázja a gyűjteményobjektumot és a gyűjteményben lévő objektumokat. Ez a paraméter a System.Collections.ICollection felületet támogató objektumok formázására szolgál. Az alapértelmezett érték az EnumOnly.

Az érvényes értékek a következők:

  • EnumOnly: Megjeleníti a gyűjtemény objektumainak tulajdonságait.
  • CoreOnly: Megjeleníti a gyűjteményobjektum tulajdonságait.
  • Mindkettő: Megjeleníti a gyűjteményobjektum és a gyűjtemény objektumainak tulajdonságait.
Type:String
Accepted values:CoreOnly, EnumOnly, Both
Position:Named
Default value:EnumOnly
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

A parancsmagot az összes hibainformáció megjelenítésére irányítja. Használja a DisplayError vagy a ShowError paraméterekkel. Alapértelmezés szerint, ha egy hibaobjektumot ír a hiba vagy a streamek jelennek meg, csak néhány hibainformáció jelenik meg.

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

-GroupBy

A kimenetet csoportokba formázhatja egy megosztott tulajdonság vagy érték alapján. Adja meg a kimenet kifejezését vagy tulajdonságát.

A GroupBy paraméter értéke lehet egy új számított tulajdonság. A számított tulajdonság lehet szkriptblokk vagy kivonattábla. Az érvényes kulcs-érték párok a következők:

  • Név (vagy címke) – <string>
  • Kifejezés – <string> vagy <script block>
  • FormatString – <string>

További információ: about_Calculated_Properties.

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

-InputObject

Megadja a formázandó objektumokat. Adjon meg egy változót, amely tartalmazza az objektumokat, vagy írjon be egy parancsot vagy kifejezést, amely lekéri az objektumokat.

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

-Property

Megadja a megjelenítésben megjelenő objektumtulajdonságokat és azok megjelenési sorrendjét. Helyettesítő karakterek használata engedélyezett.

Ha kihagyja ezt a paramétert, a megjelenítésben megjelenő tulajdonságok a megjelenített objektumtól függenek. A paraméternév tulajdonsága nem kötelező. A tulajdonság- és nézetparaméterek nem használhatók ugyanabban a parancsban.

A Tulajdonság paraméter értéke lehet egy új számított tulajdonság. A számított tulajdonság lehet szkriptblokk vagy kivonattábla. Az érvényes kulcs-érték párok a következők:

  • Kifejezés – <string> vagy <script block>
  • Mélység- <int32>

További információ: about_Calculated_Properties.

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

-ShowError

Hibákat küld a folyamaton keresztül. Ezt a paramétert ritkán használják, de hibakeresési segédként is használható, ha kifejezéseket formáz egy Format-Custom parancsban, és úgy tűnik, hogy a kifejezések nem működnek.

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

-View

Egy másik formátum vagy nézet nevét adja meg. Ha kihagyja ezt a paramétert, Format-Custom egy alapértelmezett egyéni nézetet használ. A tulajdonság- és nézetparaméterek nem használhatók ugyanabban a parancsban.

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

Bevitelek

PSObject

A parancsmaghoz bármilyen objektumot csövezhet.

Kimenetek

Microsoft.PowerShell.Commands.Internal.Format

Ez a parancsmag a megjelenítést jelképezendő formátumobjektumokat adja vissza.

Jegyzetek

A PowerShell a következő aliasokat Format-Customtartalmazza:

  • Minden platform:
    • fc

Format-Custom Olyan nézetek megjelenítésére szolgál, amelyek nem csak táblák vagy csak listák. Másik táblázatnézet megjelenítéséhez használja Format-Tablea következőt: . Alternatív listanézet megjelenítéséhez használja Format-Lista következőt: .

A GroupBy paraméter feltételezi, hogy az objektumok rendezve vannak. Mielőtt csoportosítani szeretné Format-Custom az objektumokat, rendezze Sort-Object őket.