Format-Wide
Formaterar objekt som en bred tabell som bara visar en egenskap för varje objekt.
Syntax
Default (Standard)
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 diskar som finns tillgängliga i PowerShell-registerleverantören följt av sökvägen för nycklar. 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.
Parameteregenskaper
| Typ: | SwitchParameter |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
-Column
Anger antalet kolumner i visningen. Du kan inte använda parametrarna AutoSize och Column i samma kommando.
Parameteregenskaper
| Typ: | Int32 |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | 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.
Parameteregenskaper
| Typ: | SwitchParameter |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
-Expand
Formaterar samlingsobjektet samt objekten i samlingen. Den här parametern är utformad för att formatera objekt som stöder System.Collections.ICollection-gränssnittet. 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.
Parameteregenskaper
| Typ: | String |
| Standardvärde: | EnumOnly |
| Godkända värden: | CoreOnly, EnumOnly, Both |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | 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.
Parameteregenskaper
| Typ: | SwitchParameter |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | 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. Parametern GroupBy förväntar sig att objekten sorteras. Använd cmdleten Sort-Object innan du använder Format-Wide för att gruppera objekten.
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.
Parameteregenskaper
| Typ: | Object |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | 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.
Parameteregenskaper
| Typ: | PSObject |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | True |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | 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. 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. 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.
Parameteregenskaper
| Typ: | Object |
| Standardvärde: | None |
| Stöder jokertecken: | True |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | 0 |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
-ShowError
Skickar fel genom processflödet. 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.
Parameteregenskaper
| Typ: | SwitchParameter |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
-View
Anger namnet på ett alternativt tabellformat eller en vy. Du kan inte använda parametrarna Property och View i samma kommando.
Parameteregenskaper
| Typ: | String |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
CommonParameters
Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.
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
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.
