Aangepaste opmaakbestanden

De weergave-indeling voor de objecten die worden geretourneerd door cmdlets, functies en scripts worden gedefinieerd met behulp van opmaakbestanden (format.ps1xml bestanden). Verschillende van deze bestanden worden geleverd door Windows PowerShell om de standaardweergave-indeling te definiëren voor die objecten die worden geretourneerd door Windows PowerShell-cmdlets. U kunt echter ook uw eigen aangepaste opmaakbestanden maken om de standaardweergave-indelingen te overschrijven of om de weergave van objecten te definiëren die worden geretourneerd door uw eigen opdrachten.

Windows PowerShell gebruikt de gegevens in deze opmaakbestanden om te bepalen wat er wordt weergegeven en hoe de gegevens worden opgemaakt. De weergegeven gegevens kunnen de eigenschappen van een object of de waarde van een scriptblok bevatten. Scriptblokken worden gebruikt als u een bepaalde waarde wilt weergeven die niet rechtstreeks beschikbaar is vanuit de eigenschappen van een object. U kunt bijvoorbeeld de waarde van twee eigenschappen van een object toevoegen en de som weergeven als een afzonderlijk stukje gegevens. Wanneer u uw eigen opmaakbestand schrijft, moet u weergaven definiëren voor de objecten die u wilt weergeven. U kunt één weergave definiëren voor elk object, u kunt één weergave definiëren voor meerdere objecten of u kunt meerdere weergaven voor hetzelfde object definiëren. Er is geen limiet voor het aantal weergaven dat u kunt definiëren.

Belangrijk

Het opmaken van bestanden bepaalt niet de elementen van een object dat wordt geretourneerd naar de pijplijn. Wanneer een object wordt geretourneerd naar de pijplijn, zijn alle leden van dat object beschikbaar.

Weergaven opmaken

Met opmaakweergaven kunnen objecten in een tabelindeling, een lijstindeling, een brede indeling en een aangepaste indeling worden weergegeven. Voor het grootste deel wordt elke opmaakdefinitie beschreven door een set XML-tags die een weergave beschrijven. Elke weergave bevat de naam van de weergave, de objecten die gebruikmaken van de weergave en de elementen van de weergave, zoals de kolom- en rijgegevens voor een tabelweergave.

De volgende weergaven zijn beschikbaar.

Tabelweergave Bevat de eigenschappen van een object of een scriptblokwaarde in een of meer kolommen. Elke kolom vertegenwoordigt een eigenschap van het object of een scriptblokwaarde. U kunt een tabelweergave definiëren waarin alle eigenschappen van een object, een subset van de eigenschappen van een object of een combinatie van eigenschappen en scriptblokwaarden worden weergegeven. Elke rij van de tabel vertegenwoordigt een geretourneerd object. Zie Tabelweergavevoor meer informatie over deze weergave.

Lijstweergave Bevat de eigenschappen van een object of een scriptblokwaarde in één kolom. Elke rij van de lijst bevat een optioneel label of de naam van de eigenschap, gevolgd door de waarde van de eigenschap of het scriptblok. Zie lijstweergavevoor meer informatie over deze weergave.

Brede weergave Bevat één eigenschap van een object of een scriptblokwaarde in een of meer kolommen. Er is geen label of koptekst voor deze weergave. Zie Wide Viewvoor meer informatie over deze weergave.

Aangepaste weergave Geeft een aanpasbare weergave weer van objecteigenschappen of scriptblokwaarden die niet voldoen aan de starre structuur van tabelweergaven, lijstweergaven of brede weergaven. U kunt een zelfstandige aangepaste weergave definiëren of u kunt een aangepaste weergave definiëren die wordt gebruikt door een andere weergave, zoals een tabelweergave of lijstweergave. Zie Aangepaste weergavevoor meer informatie over deze weergave.

XML-elementen weergeven

In het volgende voorbeeld ziet u de XML-tags die worden gebruikt om een tabelweergave te definiëren die twee kolommen bevat. Het element ViewDefinitions is het containerelement voor alle weergaven die zijn gedefinieerd in het opmaakbestand. Het element Weergave definieert de specifieke tabel, lijst, breed of aangepaste weergave. In elke weergave geeft het element Naam de naam van de weergave op, definieert het element ViewSelectedBy de objecten die de weergave gebruiken en de verschillende besturingselementen (zoals het TableControl-element) de indeling van de weergave.

ViewDefinitions
  <View>
    <Name>Name of View</Name>
    <ViewSelectedBy>
      <TypeName>Object to display using this view</TypeName>
      <TypeName>Object to display using this view</TypeName>
    </ViewSelectedBy>
    <TableControl>
      <TableHeaders>
        <TableColumnHeader>
          <Width></Width>
        </TableColumnHeader>
        <TableColumnHeader>
          <Width></Width>
        </TableColumnHeader>
      </TableHeaders>
      <TableRowEntries>
        <TableRowEntry>
          <TableColumnItems>
            <TableColumnItem>
              <PropertyName>Header for column 1</PropertyName>
            </TableColumnItem>
            <TableColumnItem>
              <PropertyName>Header for column 2</PropertyName>
            </TableColumnItem>
          </TableColumnItems>
        </TableRowEntry>
      </TableRowEntries>
    </TableControl)
  </View>
</ViewDefinitions>

Zie ook

tabelweergave

Lijstweergave

brede weergave

aangepaste weergave

Een Windows PowerShell-cmdlet schrijven