Delen via

Format-Custom

  • Referentie
Module:
Microsoft.PowerShell.Utility

Maakt gebruik van een aangepaste weergave om de uitvoer op te maken.

Syntaxis

Format-Custom
      [[-Property] <Object[]>]
      [-Depth <Int32>]
      [-GroupBy <Object>]
      [-View <String>]
      [-ShowError]
      [-DisplayError]
      [-Force]
      [-Expand <String>]
      [-InputObject <PSObject>]
      [<CommonParameters>]

Description

De Format-Custom cmdlet formatteert de uitvoer van een opdracht zoals gedefinieerd in een alternatieve weergave. Format-Custom is ontworpen om weergaven weer te geven die niet alleen tabellen of alleen lijsten zijn. U kunt de weergaven gebruiken die zijn gedefinieerd in de *-indeling. 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 toe te voegen aan PowerShell.

Voorbeelden

Voorbeeld 1: Uitvoer opmaken met een aangepaste weergave

Get-Command Start-Transcript | Format-Custom -View MyView

Met deze opdracht wordt informatie over de Start-Transcript cmdlet opgemaakt in de indeling die is gedefinieerd door de Weergave MyView, een aangepaste weergave die door de gebruiker is gemaakt. Als u deze opdracht wilt uitvoeren, moet u eerst een nieuw PS1XML-bestand maken, de weergave MyView definiëren en vervolgens de opdracht Update-FormatData gebruiken om het PS1XML-bestand toe te voegen aan PowerShell.

Voorbeeld 2: Uitvoer opmaken met de standaardweergave

Get-Process Winlogon | Format-Custom

Met deze opdracht wordt informatie over het Winlogon-proces opgemaakt in een alternatieve aangepaste weergave. Omdat de opdracht niet de parameter View gebruikt, gebruikt Format-Custom een standaard aangepaste weergave om de gegevens op te maken.

Voorbeeld 3: Opmaakfouten oplossen

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

PC /> Get-Date | Format-Custom DayOfWeek,{ $_ / $null } -DisplayError

class DateTime
{
  DayOfWeek = Friday
   $_ / $null  = #ERR
}


PC /> Get-Date | Format-Custom DayOfWeek,{ $_ / $null } -ShowError

class DateTime
{
  DayOfWeek = Friday
   $_ / $null  =
}

Failed to evaluate expression " $_ / $null ".
+ CategoryInfo          : InvalidArgument: (12/21/2018 8:01:04 AM:PSObject) [], RuntimeException
+ FullyQualifiedErrorId : PSPropertyExpressionError

Parameters

-Depth

Hiermee geeft u het aantal kolommen in de weergave.

Type:Int32
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-DisplayError

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

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren: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 ICollection (System.Collections). 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.
  • Beide: Geeft de eigenschappen van het verzamelingsobject en de eigenschappen van objecten in de verzameling weer.
Type:String
Geaccepteerde waarden:CoreOnly, EnumOnly, Both
Position:Named
Default value:EnumOnly
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Force

Hiermee wordt de cmdlet om alle foutgegevens weer te geven. Gebruiken met de parameters DisplayError of ShowErr or. Wanneer een foutobject standaard naar de fout- of weergavestreams wordt geschreven, wordt slechts een deel van de foutgegevens weergegeven.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren: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. Als u een berekende eigenschap wilt maken, gebruikt u een hash-tabel. Geldige sleutels zijn:

  • Naam (of label) <tekenreeks>
  • Expressie <tekenreeks> of <scriptblok>
  • FormatString <tekenreeks>
Type:Object
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-InputObject

Hiermee geeft u de objecten 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
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Property

Hiermee geeft u de objecteigenschappen op die worden weergegeven in de weergave en de volgorde waarin ze worden weergegeven. 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 eigenschap en parameters weergeven in dezelfde opdracht niet gebruiken.

De waarde van de parameter Eigenschap kan een nieuwe berekende eigenschap zijn. Als u een berekende eigenschap wilt maken, gebruikt u een hash-tabel. Geldige sleutels zijn:

  • Expressie <tekenreeks> of <scriptblok>
  • Diepte <int32>
Type:Object[]
Position:0
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:True

-ShowError

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

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-View

Hiermee geeft u de naam van een alternatieve indeling of 'weergave'. Als u deze parameter weglaat, gebruikt Format-Custom een standaard aangepaste weergave. U kunt de eigenschap en parameters weergeven in dezelfde opdracht niet gebruiken.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

PSObject

U kunt elk object doorsluisen naar Format-Custom.

Uitvoerwaarden

Microsoft.PowerShell.Commands.Internal.Format

Format-Custom retourneert de indelingsobjecten die de weergave vertegenwoordigen.

Notities

Format-Custom is ontworpen om weergaven weer te geven die niet alleen tabellen of alleen lijsten zijn. Als u een alternatieve tabelweergave wilt weergeven, gebruikt u Format-Table. Als u een alternatieve lijstweergave wilt weergeven, gebruikt u Format-List.

U kunt ook verwijzen naar Format-Custom door de ingebouwde alias 'fc'. Zie about_Aliasesvoor meer informatie.

Bij de parameter GroupBy wordt ervan uitgegaan dat de objecten zijn gesorteerd. Voordat u Format-Custom gebruikt om de objecten te groeperen, gebruikt u Sort-Object om ze te sorteren.