Format-Wide
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.
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 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.
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. 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.
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. Den beräknade egenskapen kan vara ett skriptblock eller en hash-tabell. Giltiga nyckel/värde-par är:
Name
(ellerLabel
) -<string>
Expression
-<string>
eller<script block>
FormatString
-<string>
Mer information finns i about_Calculated_Properties.
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 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.
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 Egenskap och Visa i samma kommando.
Typ: | String |
Position: | Named |
Standardvärde: | None |
Obligatorisk: | False |
Godkänn pipeline-indata: | False |
Godkänn jokertecken: | False |
Indata
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
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
.