Format-Custom

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 másik nézetben definiált parancs kimenetét formázja. Format-Custom A úgy lett kialakítva, hogy ne csak táblázatokat vagy csak listákat tartalmazó nézeteket jelenítsen meg. 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 parancsmag használatával 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 a Start-Transcript felhasználó által létrehozott egyéni nézet, a MyView nézet által meghatározott formátumban formázza a parancsmag adatait. 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 hozzá kell adnia a PS1XML-fájlt a PowerShellhez.

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

Get-Process Winlogon | Format-Custom

Ez a parancs egy másik, testre szabott nézetben formázja a Winlogon-folyamat adatait. Mivel a parancs nem a View paramétert használja, 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
Accept pipeline input:False
Accept wildcard characters:False

-DisplayError

Hibákat jelenít meg 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
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
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 a hiba vagy a megjelenítési adatfolyamok között írnak, csak a hibainformációk egy része jelenik meg.

Type:SwitchParameter
Position:Named
Default value:None
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
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
Accept pipeline input:True
Accept wildcard characters:False

-Property

Meghatározza 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
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
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
Accept pipeline input:False
Accept wildcard characters:False

Bevitelek

PSObject

Bármilyen objektumot átirányíthat a parancsra Format-Custom.

Kimenetek

Microsoft.PowerShell.Commands.Internal.Format

Format-Custom A a megjelenítést jelképezõ formátumobjektumokat adja vissza.

Jegyzetek

Format-Custom A úgy lett kialakítva, hogy ne csak táblázatokat vagy csak listákat tartalmazó nézeteket jelenítsen meg. 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 a következőt Format-List: .

A beépített aliasra is hivatkozhatFormat-Custom. fc További információ: about_Aliases.

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