Dela via

Format-Wide

  • Referens
Modul:
Microsoft.PowerShell.Utility

Formaterar objekt som en bred tabell som bara visar en egenskap för varje objekt.

Syntax

Format-Wide
      [[-Property] <Object>]
      [-AutoSize]
      [-Column <int>]
      [-GroupBy <Object>]
      [-View <string>]
       [-ShowError]
      [-DisplayError]
      [-Force]
      [-Expand <string>]
      [-InputObject <psobject>] 
      [<CommonParameters>]

Description

Cmdleten Format-Wide formaterar objekt som en bred tabell som endast visar en egenskap för varje objekt. Du kan använda parametern Egenskap för att avgöra vilken egenskap som visas.

Exempel

Exempel 1: Formatera namn på filer i den aktuella katalogen

Det här kommandot visar namnen på filer i den aktuella katalogen i tre kolumner på skärmen.

Get-ChildItem | Format-Wide -Column 3

Cmdleten Get-ChildItem hämtar objekt som representerar varje fil i katalogen. Pipelineoperatorn (|) skickar filobjekten via pipelinen till Format-Wide, som formaterar dem för utdata. Parametern Column anger antalet kolumner.

Exempel 2: Formatera namn på registernycklar

Det här kommandot visar namnen på registernycklarna i HKEY_CURRENT_USER\Software\Microsoft-nyckeln.

Get-ChildItem HKCU:\software\microsoft | Format-Wide -Property pschildname -AutoSize

Cmdleten Get-ChildItem hämtar objekt som representerar nycklarna. Sökvägen anges som HKCU:, en av de enheter som exponeras av PowerShell-registerprovidern, följt av nyckelsökvägen. Pipelineoperatorn (|) skickar registernyckelobjekten via pipelinen till Format-Wide, som formaterar dem för utdata. Parametern Property anger namnet på egenskapen och parametern AutoSize justerar kolumnerna för läsbarhet.

Exempel 3: Felsöka formatfel

Följande exempel visar resultatet av att lägga till parametrarna DisplayError eller ShowError med ett uttryck.

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

Parametrar

-AutoSize

Justerar kolumnstorleken och antalet kolumner baserat på databredden. Som standard bestäms kolumnstorleken och talet av vyn. Du kan inte använda parametrarna AutoSize och Column i samma kommando.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Column

Anger antalet kolumner i visningen. Du kan inte använda parametrarna AutoSize och Column i samma kommando.

Typ:Int32
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-DisplayError

Visar fel på kommandoraden. Den här parametern används sällan, men kan användas som felsökningshjälp när du formaterar uttryck i ett Format-Wide kommando och uttrycken inte verkar fungera.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Expand

Formaterar samlingsobjektet samt objekten i samlingen. Den här parametern är utformad för att formatera objekt som stöder gränssnittet ICollection (System.Collections). Standardvärdet är EnumOnly.

Giltiga värden är:

  • EnumOnly: Visar egenskaperna för objekten i samlingen.
  • CoreOnly: Visar egenskaperna för samlingsobjektet.
  • Båda: Visar egenskaperna för samlingsobjektet och egenskaperna för objekt i samlingen.
Typ:String
Godkända värden:CoreOnly, EnumOnly, Both
Position:Named
Standardvärde:EnumOnly
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Force

Anger att denna cmdlet åsidosätter begränsningar som hindrar kommandot från att lyckas, bara så att ändringarna inte äventyrar säkerheten. Till exempel åsidosätter Force det skrivskyddade attributet eller skapar kataloger för att slutföra en filsökväg, men det kommer inte att försöka ändra filbehörigheter.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-GroupBy

Formaterar utdata i grupper baserat på en delad egenskap eller ett delat värde. Ange ett uttryck eller en egenskap för utdata.

Värdet för parametern GroupBy kan vara en ny beräknad egenskap. Om du vill skapa en beräknad egenskap använder du en hash-tabell. De godtagbara värdena för den här parametern är:

  • Namn (eller etikett) <sträng>
  • Uttryck <sträng> eller <skriptblock>
  • FormatString <sträng>
Typ:Object
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-InputObject

Anger vilka objekt som ska formateras. Ange en variabel som innehåller objekten eller skriv ett kommando eller uttryck som hämtar objekten.

Typ:PSObject
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Property

Anger de objektegenskaper som visas i visningen och i vilken ordning de visas. Jokertecken tillåts.

Om du utelämnar den här parametern beror egenskaperna som visas i visningen på det objekt som visas. Parameternamnet "Egenskap" är valfritt. Du kan inte använda parametrarna Property och View i samma kommando.

Värdet för parametern Property kan vara en ny beräknad egenskap. Om du vill skapa en beräknad egenskap använder du en hash-tabell. Giltiga nycklar är:

  • Uttryck <sträng> eller <skriptblock>
  • FormatString <sträng>
Typ:Object
Position:0
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:True

-ShowError

Skickar fel via pipelinen. Den här parametern används sällan, men kan användas som felsökningshjälp när du formaterar uttryck i ett Format-Wide kommando och uttrycken inte verkar fungera.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-View

Anger namnet på ett alternativt tabellformat eller en vy. Du kan inte använda parametrarna Property och View i samma kommando.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Indata

PSObject

Du kan skicka valfritt objekt till Format-Wide.

Utdata

Microsoft.PowerShell.Commands.Internal.Format

Format-Wide returnerar formatobjekt som representerar tabellen.

Kommentarer

Du kan också referera till Format-Wide med dess inbyggda alias, fw. Mer information finns i about_Aliases.

Parametern GroupBy förutsätter att objekten sorteras. Använd Sort-Object innan du använder Format-Custom för att gruppera objekten.

Med parametern View kan du ange ett alternativt format för tabellen. Du kan använda vyerna som definierats i *.format.PS1XML-filerna i PowerShell-katalogen eller skapa egna vyer i nya PS1XML-filer och använda cmdleten Update-FormatData för att inkludera dem i PowerShell.

Den alternativa vyn för parametern View måste använda tabellformat. om det inte gör det misslyckas kommandot. Om den alternativa vyn är en lista använder du Format-List. Om den alternativa vyn varken är en lista eller en tabell använder du Format-Custom.