Format-Wide
Az objektumokat széles táblázatként formázja, amely az egyes objektumoknak csak egy tulajdonságát jeleníti meg.
Syntax
Default (Alapértelmezett)
Format-Wide
[[-Property] <Object>]
[-AutoSize]
[-Column <int>]
[-GroupBy <Object>]
[-View <string>]
[-ShowError]
[-DisplayError]
[-Force]
[-Expand <string>]
[-InputObject <psobject>]
[<CommonParameters>]
Description
A Format-Wide parancsmag széles táblázatként formázta az objektumokat, amelyek az egyes objektumoknak csak egy tulajdonságát jelenítik meg. A Tulajdonság paraméter használatával meghatározhatja, hogy melyik tulajdonság jelenjen meg.
Példák
1. példa: Fájlok neveinek formázása az aktuális könyvtárban
Ez a parancs a képernyő három oszlopában jeleníti meg az aktuális könyvtárban lévő fájlok nevét.
Get-ChildItem | Format-Wide -Column 3
A Get-ChildItem parancsmag a könyvtár minden fájlját képviselő objektumokat kap. A folyamatkezelő (|) átadja a fájlobjektumokat a folyamaton keresztül a Format-Wide, amely kimenetként formázza őket. A Oszlop paraméter határozza meg az oszlopok számát.
2. példa: Rendszerleíró kulcsok nevének formázása
Ez a parancs megjeleníti a beállításkulcsok nevét a HKEY_CURRENT_USER\Software\Microsoft kulcsban.
Get-ChildItem HKCU:\software\microsoft | Format-Wide -Property pschildname -AutoSize
A Get-ChildItem parancsmag lekéri a kulcsokat jelképező objektumokat. Az elérési út HKCU-ként van megadva: a PowerShell-beállításjegyzék-szolgáltató által közzétett egyik meghajtó, amelyet a kulcs elérési útja követ. A folyamatkezelő (|) átadja a beállításkulcs-objektumokat a folyamaton keresztül a Format-Wide, amely kimenetként formázza őket. A tulajdonság paraméter adja meg a tulajdonság nevét, az Automatikus méretezés paraméter pedig az olvashatóság érdekében módosítja az oszlopokat.
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.
PS /> Get-Date | Format-Wide { $_ / $null } -DisplayError
#ERR
PS /> Get-Date | Format-Wide { $_ / $null } -ShowError
Failed to evaluate expression " $_ / $null ".
+ CategoryInfo : InvalidArgument: (12/21/2018 8:18:01 AM:PSObject) [], RuntimeException
+ FullyQualifiedErrorId : PSPropertyExpressionError
Paraméterek
-AutoSize
Az adatok szélessége alapján módosítja az oszlopok méretét és számát. Alapértelmezés szerint az oszlop méretét és számát a nézet határozza meg. Az automatikus méretezési és Oszlop paraméterek nem használhatók ugyanabban a parancsban.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Column
A megjelenítendő oszlopok számát adja meg. Az automatikus méretezési és Oszlop paraméterek nem használhatók ugyanabban a parancsban.
Paramétertulajdonságok
| Típus: | Int32 |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | 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-Wide parancsban, és úgy tűnik, hogy a kifejezések nem működnek.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Expand
Formázja a gyűjteményobjektumot és a gyűjteményben lévő objektumokat. Ez a paraméter az ICollection (System.Collections) 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 tulajdonságait és a gyűjteményben lévő objektumok tulajdonságait.
Paramétertulajdonságok
| Típus: | String |
| Alapértelmezett érték: | EnumOnly |
| Elfogadott értékek: | CoreOnly, EnumOnly, Both |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Force
Azt jelzi, hogy ez a parancsmag felülírja azokat a korlátozásokat, amelyek megakadályozzák a parancs sikerességét, csak azért, hogy a módosítások ne veszélyeztessék a biztonságot. Például a Force felülbírálja az írásvédett attribútumot, vagy könyvtárakat hoz létre a fájl elérési útjának befejezéséhez, de nem fog próbálkozni a fájlengedélyek módosításával.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | 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 új számított tulajdonság lehet. Számított tulajdonság létrehozásához használjon kivonattáblát. A paraméter elfogadható értékei a következők:
- Név (vagy címke) <sztring>
- Kifejezés <sztring> vagy <szkriptblokkoló>
- FormatString <sztring>
Paramétertulajdonságok
| Típus: | Object |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | 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.
Paramétertulajdonságok
| Típus: | PSObject |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | True |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | 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 "Tulajdonság" paraméternév megadása nem kötelező. Nem használhatja ugyanabban a parancsban a tulajdonság és a View paramétereket.
A tulajdonság paraméter értéke új számított tulajdonság lehet. Számított tulajdonság létrehozásához használjon kivonattáblát. Az érvényes kulcsok a következők:
- Kifejezés <sztring> vagy <szkriptblokkoló>
- FormatString <sztring>
Paramétertulajdonságok
| Típus: | Object |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | True |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | 0 |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-ShowError
Hibákat továbbít a csővezetéken 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-Wide parancsban, és úgy tűnik, hogy a kifejezések nem működnek.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-View
Egy másik táblázatformátum vagy nézet nevét adja meg. Nem használhatja ugyanabban a parancsban a tulajdonság és a View paramétereket.
Paramétertulajdonságok
| Típus: | String |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
CommonParameters
Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.
Bevitelek
PSObject
Bármilyen objektumot becsúszthat Format-Wide.
Kimenetek
Microsoft.PowerShell.Commands.Internal.Format
Format-Wide a táblát képviselő formázási objektumokat adja vissza.
Jegyzetek
A Format-Wide is hivatkozhat a beépített aliasára, fw. További információ: about_Aliases.
A GroupBy paraméter feltételezi, hogy az objektumok rendezve vannak. Az objektumok csoportosításához használja Sort-Object a Format-Custom használata előtt.
A View paraméter lehetővé teszi a táblázat alternatív formátumának megadását. Használhatja a PowerShell-címtár *.format.PS1XML fájljaiban definiált nézeteket, vagy létrehozhat saját nézeteket új PS1XML-fájlokban, és a Update-FormatData parancsmaggal felveheti őket a PowerShellbe.
A Nézet paraméter alternatív nézetének táblaformátumot kell használnia; ha nem, a parancs meghiúsul. Ha az alternatív nézet egy lista, használja a Format-List-at. Ha a másik nézet sem lista, sem táblázat, használja a Format-Custom parancsot.