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 egenskapsparametern 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 Kolumn anger antalet kolumner.

Exempel 2: Formatera namn på registernycklar

Det här kommandot visar namnen på registernycklarna HKEY_CURRENT_USER\Software\Microsoft i 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 , en av de enheter som HKCU:exponeras av PowerShell-registerprovidern, följt av nyckelsökvägen. Pipelineoperatorn (|) skickar registernyckelobjekten via pipelinen till Format-Wide, som formaterar dem för utdata. Egenskapsparametern anger namnet på egenskapen och parametern AutoSize justerar kolumnerna för läsbarhet.

Exempel 3: Felsöka formatfel

I följande exempel visas 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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Column

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

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Expand

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

Giltiga värden är:

  • EnumOnly: Visar egenskaperna för objekten i samlingen.
  • CoreOnly: Visar egenskaperna för samlingsobjektet.
  • Both: Visar egenskaperna för samlingsobjektet och egenskaperna för objekt i samlingen.
Type:String
Accepted values:CoreOnly, EnumOnly, Both
Position:Named
Default value:EnumOnly
Required:False
Accept pipeline input:False
Accept wildcard characters: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. Force åsidosätter till exempel det skrivskyddade attributet eller skapar kataloger för att slutföra en filsökväg, men försöker inte ändra filbehörigheter.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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. Den beräknade egenskapen kan vara ett skriptblock eller en hash-tabell. Giltiga nyckel/värde-par är:

  • Name (eller Label) - <string>
  • Expression - <string> eller <script block>
  • FormatString - <string>

Mer information finns i about_Calculated_Properties.

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

Type:PSObject
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Property

Anger den objektegenskap som visas i visningen. Jokertecken tillåts.

Om du utelämnar den här parametern beror egenskaperna som visas i visningen på det objekt som visas. Parameternamnegenskapen är valfri. Du kan inte använda parametrarna Egenskap och Visa i samma kommando.

Värdet för egenskapsparametern kan vara en ny beräknad egenskap. Den beräknade egenskapen kan vara ett skriptblock eller en hash-tabell. Giltiga nyckel/värde-par är:

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

Mer information finns i about_Calculated_Properties.

Type:Object
Position:0
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-View

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Indata

PSObject

Du kan skicka valfritt objekt till den här cmdleten.

Utdata

Microsoft.PowerShell.Commands.Internal.Format

Den här cmdleten returnerar formatobjekt som representerar tabellen.

Kommentarer

PowerShell innehåller följande alias för Format-Wide:

  • Alla plattformar:
    • fw

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 Visa 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 den 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.