Delen via

Format-Wide

Module:
Microsoft.PowerShell.Utility Module

Hiermee worden objecten opgemaakt als een brede tabel met slechts één eigenschap van elk object.

Syntaxis

Default (Standaard) 

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

Description

De Format-Wide cmdlet formatteert objecten als een brede tabel die slechts één eigenschap van elk object weergeeft. U kunt de parameter eigenschap gebruiken om te bepalen welke eigenschap wordt weergegeven.

Voorbeelden

Voorbeeld 1: Namen van bestanden opmaken in de huidige map

Met deze opdracht worden de namen van bestanden in de huidige map weergegeven in drie kolommen op het scherm.

Get-ChildItem | Format-Wide -Column 3

De Get-ChildItem cmdlet haalt objecten op die elk bestand in de map vertegenwoordigen. De pijplijnoperator (|) geeft de bestandsobjecten door aan Format-Wide, waarmee ze worden opgemaakt voor uitvoer. De parameter Kolom geeft het aantal kolommen op.

Voorbeeld 2: Namen van registersleutels opmaken

Met deze opdracht worden de namen van registersleutels in de HKEY_CURRENT_USER\Software\Microsoft-sleutel weergegeven.

Get-ChildItem HKCU:\software\Microsoft | Format-Wide -Property PSChildName -AutoSize

Met de cmdlet Get-ChildItem worden objecten opgehaald die de sleutels vertegenwoordigen. Het pad wordt opgegeven als HKCU:, een van de schijven die door de PowerShell-registerprovider beschikbaar zijn gesteld, gevolgd door het sleutelpad. De pijplijnoperator (|) geeft de registersleutelobjecten via de pijplijn door aan Format-Wide, waarmee ze worden opgemaakt voor uitvoer. De parameter eigenschap geeft de naam van de eigenschap op en de parameter AutoSize past de kolommen aan voor leesbaarheid.

Voorbeeld 3: Opmaakfouten oplossen

In de volgende voorbeelden ziet u de resultaten van het toevoegen van de DisplayError- of ShowError parameters met een expressie.

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

Parameters

-AutoSize

Hiermee past u de kolomgrootte en het aantal kolommen aan op basis van de breedte van de gegevens. Standaard worden de kolomgrootte en het getal bepaald door de weergave. U kunt de parameters AutoSize en Column niet gebruiken in dezelfde opdracht.

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Column

Hiermee geeft u het aantal kolommen in de weergave. U kunt de parameters AutoSize en Column niet gebruiken in dezelfde opdracht.

Parametereigenschappen

Type:Int32
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-DisplayError

Toont fouten op de opdrachtregel. Deze parameter wordt zelden gebruikt, maar kan worden gebruikt als foutopsporingshulpmiddel wanneer u expressies in een Format-Wide opdracht opmaakt en de expressies niet werken.

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Expand

Formatteert het verzamelingsobject en de objecten in de verzameling. Deze parameter is ontworpen om objecten op te maken die ondersteuning bieden voor de System.Collections.ICollection interface. De standaardwaarde is EnumOnly.

Geldige waarden zijn:

  • EnumOnly: geeft de eigenschappen van de objecten in de verzameling weer.
  • CoreOnly: geeft de eigenschappen van het verzamelingsobject weer.
  • Both: geeft de eigenschappen van het verzamelingsobject en de eigenschappen van objecten in de verzameling weer.

Parametereigenschappen

Type:String
Default value:EnumOnly
Geaccepteerde waarden:CoreOnly, EnumOnly, Both
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Force

Geeft aan dat deze cmdlet beperkingen overschrijft die verhinderen dat de opdracht slaagt, zodat de wijzigingen geen inbreuk maken op de beveiliging. Force zal bijvoorbeeld het kenmerk 'alleen-lezen' negeren of mappen aanmaken om een bestandspad te voltooien, maar zal niet proberen bestandsmachtigingen te wijzigen.

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-GroupBy

Hiermee wordt de uitvoer in groepen opgemaakt op basis van een gedeelde eigenschap of waarde. Voer een expressie of een eigenschap van de uitvoer in. De parameter GroupBy verwacht dat de objecten zijn gesorteerd. Gebruik de cmdlet Sort-Object voordat u Format-Wide gebruikt om de objecten te groeperen.

De waarde van de parameter GroupBy kan een nieuwe berekende eigenschap zijn. De berekende eigenschap kan een scriptblok of een hash-tabel zijn. Geldige sleutel-waardeparen zijn:

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

Zie about_Calculated_Propertiesvoor meer informatie.

Parametereigenschappen

Type:Object
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-InputObject

Hiermee geeft u de objecten op die moeten worden opgemaakt. Voer een variabele in die de objecten bevat of typ een opdracht of expressie waarmee de objecten worden opgehaald.

Parametereigenschappen

Type:PSObject
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:True
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Property

Hiermee geeft u de objecteigenschap op die wordt weergegeven in de weergave. Wildcards zijn toegestaan.

Als u deze parameter weglaat, zijn de eigenschappen die in de weergave worden weergegeven afhankelijk van het object dat wordt weergegeven. De parameternaam eigenschap is optioneel. U kunt de Property en de View parameters niet in dezelfde opdracht gebruiken.

De waarde van de parameter eigenschap kan een nieuwe berekende eigenschap zijn. De berekende eigenschap kan een scriptblok of een hash-tabel zijn. Geldige sleutel-waardeparen zijn:

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

Zie about_Calculated_Propertiesvoor meer informatie.

Parametereigenschappen

Type:Object
Default value:None
Ondersteunt jokertekens:True
DontShow:False

Parametersets

(All)
Position:0
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-ShowError

Verzendt fouten door de pijplijn. Deze parameter wordt zelden gebruikt, maar kan worden gebruikt als foutopsporingshulpmiddel wanneer u expressies in een Format-Wide opdracht opmaakt en de expressies niet werken.

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-View

Hiermee geeft u de naam van een alternatieve tabelindeling of weergave. U kunt de Property en de View parameters niet in dezelfde opdracht gebruiken.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

CommonParameters

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

Invoerwaarden

PSObject

U kunt elk object doorsluisen naar deze cmdlet.

Uitvoerwaarden

Microsoft.PowerShell.Commands.Internal.Format

Met deze cmdlet worden indelingsobjecten geretourneerd die de tabel vertegenwoordigen.

Notities

PowerShell bevat de volgende aliassen voor Format-Wide:

  • Alle platforms:
    • fw

Met de parameter View kunt u een alternatieve indeling voor de tabel opgeven. U kunt de weergaven gebruiken die zijn gedefinieerd in de *.format.ps1xml-bestanden in de PowerShell-map of u kunt uw eigen weergaven maken in nieuwe PS1XML-bestanden en de Update-FormatData-cmdlet gebruiken om ze op te nemen in PowerShell.

De alternatieve weergave voor de parameter Weergave moet de tabelindeling gebruiken; Als dit niet het geval is, mislukt de opdracht. Als de alternatieve weergave een lijst is, gebruikt u Format-List. Als de alternatieve weergave geen lijst of tabel is, gebruikt u Format-Custom.