Megosztás a következőn keresztül:

Format-Wide

  • Referencia
Modul:
Microsoft.PowerShell.Utility

Az objektumokat széles táblázatként formázja, amely az egyes objektumoknak csak egy tulajdonságát jeleníti meg.

Syntax

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ázja 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árban lévő egyes fájlokat képviselő objektumokat kap. A folyamatüzemeltető (|) átadja a fájlobjektumokat a folyamaton Format-Widekeresztül, amely kimenetként formázza őket. Az Oszlop paraméter az oszlopok számát határozza meg.

2. példa: Beállításkulcsok nevének formázása

Ez a parancs megjeleníti a kulcs beállításkulcsainak HKEY_CURRENT_USER\Software\Microsoft nevét.

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 a PowerShell-beállításjegyzék-szolgáltató által közzétett meghajtók egyikeként van megadva HKCU:, amelyet a kulcs elérési útja követ. A folyamatkezelő (|) átadja a beállításkulcs-objektumokat a folyamaton Format-Widekeresztül, amely kimenetként formázza őket. A Tulajdonság paraméter megadja 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. Ugyanabban a parancsban nem használhatja az Automatikus méretezés és az Oszlop paramétert.

Típus:SwitchParameter
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-Column

A megjelenítendő oszlopok számát adja meg. Ugyanabban a parancsban nem használhatja az Automatikus méretezés és az Oszlop paramétert.

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-Wide 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 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.
  • Both: Megjeleníti a gyűjteményobjektum tulajdonságait és a gyűjteményben lévő objektumok 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

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. A Force például felülírja az írásvédett attribútumot, vagy könyvtárakat hoz létre egy fájl elérési útjának befejezéséhez, de nem próbálja meg módosítani a fájlengedélyeket.

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:

  • Name (vagy Label) - <string>
  • Expression - <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ágot. 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:

  • Expression - <string> vagy <script block>
  • FormatString - <string>

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-Wide 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 táblázatformátum vagy nézet nevét adja meg. 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

PSObject

A parancsmaghoz bármilyen objektumot csövezhet.

Kimenetek

Microsoft.PowerShell.Commands.Internal.Format

Ez a parancsmag a táblázatot képviselő formázási objektumokat adja vissza.

Jegyzetek

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

  • Minden platform:
    • fw

A GroupBy paraméter feltételezi, hogy az objektumok rendezve vannak. Használja Sort-Object az objektumok csoportosítása előtt Format-Custom .

A Nézet paraméter lehetővé teszi a táblázat alternatív formátumának megadását. Használhatja a PowerShell-címtárban lévő *.format.PS1XML fájlokban definiált nézeteket, vagy létrehozhat saját nézeteket az új PS1XML-fájlokban, és a parancsmaggal felveheti őket a Update-FormatData 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 lista, használja a következőt Format-List: Ha a másik nézet sem lista, sem táblázat, használja a következőt Format-Custom: