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 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.
Típus: | Int32 |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | 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.
Típus: | SwitchParameter |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | 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.
Típus: | String |
Elfogadott értékek: | CoreOnly, EnumOnly, Both |
Position: | Named |
Alapértelmezett érték: | EnumOnly |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | 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.
Típus: | SwitchParameter |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | 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.
Típus: | Object |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | 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.
Típus: | PSObject |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | 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.
Típus: | Object[] |
Position: | 0 |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | 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.
Típus: | SwitchParameter |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | 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.
Típus: | String |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
Bevitelek
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-Custom
tartalmazza:
- 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-Table
a következőt: . Alternatív listanézet megjelenítéséhez használja Format-List
a 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.