Format-Wide
Hiermee worden objecten opgemaakt als een brede tabel waarin slechts één eigenschap van elk object wordt weergegeven.
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 waarin slechts één eigenschap van elk object wordt weergegeven. U kunt de parameter Eigenschap gebruiken om te bepalen welke eigenschap wordt weergegeven.
Voorbeelden
Voorbeeld 1: Namen van bestanden in de huidige map opmaken
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 via de pijplijn door aan Format-Wide
, waarmee ze worden opgemaakt voor uitvoer. De kolomparameter 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 Registry-provider, 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 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 aantal bepaald door de weergave. U kunt de parameters AutoSize en Column niet in dezelfde opdracht gebruiken.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Column
Hiermee geeft u het aantal kolommen in de weergave. U kunt de parameters AutoSize en Column niet in dezelfde opdracht gebruiken.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
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 een hulpmiddel voor foutopsporing wanneer u expressies opmaakt in een Format-Wide
opdracht en de expressies lijken niet te werken.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Force
Geeft aan dat deze cmdlet beperkingen overschrijft die verhinderen dat de opdracht slaagt, zodat de wijzigingen de beveiliging niet in gevaar brengen. Met Force wordt bijvoorbeeld het kenmerk Alleen-lezen overschreven of worden mappen gemaakt om een bestandspad te voltooien, maar wordt niet geprobeerd bestandsmachtigingen te wijzigen.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
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 parameter GroupBy kan een nieuwe berekende eigenschap zijn. De berekende eigenschap kan een scriptblok of een hash-tabel zijn. Geldige sleutel-waardeparen zijn:
Name
(ofLabel
) -<string>
Expression
-<string>
Of<script block>
FormatString
-<string>
Zie about_Calculated_Properties voor meer informatie.
Type: | Object |
Position: | Named |
Default value: | None |
Required: | False |
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 |
Required: | False |
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 parameternaam Eigenschap is optioneel. U kunt de parameters Eigenschap en Weergave 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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-ShowError
Verzendt fouten via de pijplijn. Deze parameter wordt zelden gebruikt, maar kan worden gebruikt als een hulpmiddel voor foutopsporing wanneer u expressies opmaakt in een Format-Wide
opdracht en de expressies lijken niet te werken.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-View
Hiermee geeft u de naam van een alternatieve tabelindeling of weergave. U kunt de parameters Eigenschap en Weergave niet in dezelfde opdracht gebruiken.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Invoerwaarden
U kunt elk object doorsnijden naar deze cmdlet.
Uitvoerwaarden
Microsoft.PowerShell.Commands.Internal.Format
Deze cmdlet retourneert opmaakobjecten die de tabel vertegenwoordigen.
Notities
PowerShell bevat de volgende aliassen voor Format-Wide
:
- Alle platformen:
fw
Bij de parameter GroupBy wordt ervan uitgegaan dat de objecten zijn gesorteerd. Gebruik Sort-Object
voor gebruik Format-Custom
om de objecten te 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 deze op te nemen in PowerShell.
De alternatieve weergave voor de weergaveparameter moet tabelindeling gebruiken; Als dit niet het geval is, mislukt de opdracht. Als de alternatieve weergave een lijst is, gebruikt Format-List
u . Als de alternatieve weergave geen lijst of tabel is, gebruikt u Format-Custom
.