Aangepaste opmaakbestanden

De weergave-indeling voor de objecten die worden geretourneerd door cmdlets, functies en scripts, wordt gedefinieerd met behulp van opmaakbestanden (format.ps1xml-bestanden). Verschillende van deze bestanden worden geleverd door Windows PowerShell standaardweergave-indeling te definiëren voor de 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 te definiëren van objecten die door uw eigen opdrachten worden geretourneerd.

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 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 voor meerdere objecten definiëren of u kunt meerdere weergaven voor hetzelfde object definiëren. Er is geen limiet voor het aantal weergaven dat u kunt definiëren.

Belangrijk

Opmaakbestanden bepalen 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

Opmaakweergaven kunnen objecten weergeven in een tabelindeling, een lijstindeling, een brede indeling en een aangepaste indeling. 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 scriptblokwaarde in een of meer kolommen. Elke kolom vertegenwoordigt een eigenschap van het object of een scriptblokwaarde. U kunt een tabelweergave definiëren met alle eigenschappen van een object, een subset van de eigenschappen van een object of een combinatie van eigenschappen en scriptblokwaarden. Elke rij van de tabel vertegenwoordigt een geretourneerd object. Zie Tabelweergave voor meer informatie over deze weergave.

Lijstweergave bevat de eigenschappen van een object of een scriptblokwaarde in één kolom. In elke rij van de lijst wordt een optioneel label of de naam van de eigenschap weergegeven, gevolgd door de waarde van de eigenschap of het scriptblok. Zie Lijstweergave voor 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 View voor meer informatie over deze weergave.

Aangepaste weergave Geeft een aanpasbare weergave weer van objecteigenschappen of scriptblokwaarden die niet voldoen aan de strikte 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 weergave voor meer informatie over deze weergave.

XML-elementen weergeven

In het volgende voorbeeld ziet u de XML-tags die worden gebruikt voor het definiëren van een tabelweergave die twee kolommen bevat. Het element ViewDefinitions is het containerelement voor alle weergaven die in het opmaakbestand zijn gedefinieerd. Het element Weergave definieert de specifieke tabel, lijst, brede of aangepaste weergave. In elke weergave geeft het element Naam de naam van de weergave op, het element ViewSelectedBy definieert de objecten die gebruikmaken van de weergave en de verschillende besturingselementelementen (zoals het element) definiëren de indeling van TableControl 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