Feedback

Format-Wide

  • Referentie
Module:
Microsoft.PowerShell.Utility

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

Syntax

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

Description

Met de Format-Wide cmdlet worden objecten opgemaakt als een brede tabel met slechts één eigenschap van elk object. 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 de pijplijn 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

De Get-ChildItem cmdlet haalt objecten op die de sleutels vertegenwoordigen. Het pad wordt opgegeven als HKCU:een van de stations die worden weergegeven door de PowerShell-registerprovider, gevolgd door het sleutelpad. De pijplijnoperator (|) geeft de registersleutelobjecten door aan de pijplijn Format-Wide, waarmee deze 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 parameters DisplayError of ShowError 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 Automatisch aanpassen en Kolom niet gebruiken in dezelfde opdracht.

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

Hiermee geeft u het aantal kolommen in de weergave. U kunt de parameters Automatisch aanpassen en Kolom niet gebruiken in dezelfde opdracht.

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DisplayError

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

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

Hiermee wordt het verzamelingsobject en de objecten in de verzameling opgemaakt. Deze parameter is ontworpen om objecten op te maken die ondersteuning bieden voor de interface System.Collections.ICollection . 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.
Type:String
Accepted values:CoreOnly, EnumOnly, Both
Position:Named
Default value:EnumOnly
Accept pipeline input:False
Accept wildcard characters:False
-Force

Hiermee wordt aangegeven dat met deze cmdlet beperkingen worden overschreven die verhinderen dat de opdracht slaagt, zodat de wijzigingen geen inbreuk maken op de beveiliging. Force overschrijft bijvoorbeeld het kenmerk Alleen-lezen of maakt mappen om een bestandspad te voltooien, maar probeert geen bestandsmachtigingen te wijzigen.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters: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 waarde van de GroupBy-parameter 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_Properties voor meer informatie.

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

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

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

Als u deze parameter weglaat, zijn de eigenschappen die in de weergave worden weergegeven, afhankelijk van het object dat wordt weergegeven. De eigenschap parameternaam is optioneel. U kunt de eigenschaps- en weergaveparameters 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_Properties voor meer informatie.

Type:Object
Position:0
Default value:None
Accept pipeline input:False
Accept wildcard characters:True
-ShowError

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

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

Hiermee geeft u de naam van een alternatieve tabelindeling of weergave. U kunt de eigenschaps- en weergaveparameters niet in dezelfde opdracht gebruiken.

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

Invoerwaarden

PSObject

U kunt elk object doorsluisen naar Format-Wide.

Uitvoerwaarden

Microsoft.PowerShell.Commands.Internal.Format

Format-Wide retourneert indelingsobjecten die de tabel vertegenwoordigen.

Notities

U kunt ook verwijzen naar Format-Wide de ingebouwde alias. fw Zie about_Aliases voor meer informatie.

Bij de parameter GroupBy wordt ervan uitgegaan dat de objecten worden gesorteerd. Gebruik Sort-Object deze functie voordat u Format-Custom de objecten groeperen.

Met de parameter Weergave 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.