Anpassade formateringsfiler

Visningsformatet för objekt som returneras av cmdlets, funktioner och skript definieras med hjälp av formateringsfiler (format.ps1xml-filer). Flera av dessa filer tillhandahålls av Windows PowerShell för att definiera standardvisningsformatet för de objekt som returneras av Windows PowerShell cmdlets. Men du kan också skapa egna anpassade formateringsfiler för att skriva över standardvisningsformaten eller definiera visningen av objekt som returneras av dina egna kommandon.

Windows PowerShell använder data i de här formateringsfilerna för att avgöra vad som visas och hur data formateras. Data som visas kan innehålla egenskaperna för ett objekt eller värdet för ett skriptblock. Skriptblock används om du vill visa ett värde som inte är tillgängligt direkt från egenskaperna för ett objekt. Du kanske till exempel vill lägga till värdet för två egenskaper för ett objekt och visa summan som en separat databit. När du skriver en egen formateringsfil måste du definiera vyer för de objekt som du vill visa. Du kan definiera en enskild vy för varje objekt, definiera en enda vy för flera objekt eller definiera flera vyer för samma objekt. Det finns ingen gräns för hur många vyer som du kan definiera.

Viktigt

Formatering av filer avgör inte elementen i ett objekt som returneras till pipelinen. När ett objekt returneras till pipelinen är alla medlemmar i objektet tillgängliga.

Formatvyer

Formateringsvyer kan visa objekt i tabellformat, ett listformat, ett brett format och ett anpassat format. I de flesta fall beskrivs varje formateringsdefinition av en uppsättning XML-taggar som beskriver en vy. Varje vy innehåller namnet på vyn, objekten som använder vyn och elementen i vyn, till exempel kolumn- och radinformation för en tabellvy.

Följande vyer är tillgängliga.

Tabellvy Listar egenskaperna för ett objekt eller ett skriptblockvärde i en eller flera kolumner. Varje kolumn representerar en egenskap för objektet eller ett skriptblockvärde. Du kan definiera en tabellvy som visar alla egenskaper för ett objekt, en delmängd av egenskaperna för ett objekt eller en kombination av egenskaper och skriptblockvärden. Varje rad i tabellen representerar ett returnerat objekt. Mer information om den här vyn finns i Tabellvy.

Listvy Listar egenskaperna för ett objekt eller ett skriptblockvärde i en enda kolumn. Varje rad i listan visar en valfri etikett eller egenskapsnamnet följt av värdet för egenskapen eller skriptblocket. Mer information om den här vyn finns i Listvy.

Bred vy Visar en enskild egenskap för ett objekt eller ett skriptblockvärde i en eller flera kolumner. Det finns ingen etikett eller rubrik för den här vyn. Mer information om den här vyn finns i Bred vy.

Anpassad vy Visar en anpassningsbar vy över objektegenskaper eller skriptblockvärden som inte följer den fasta strukturen för tabellvyer, listvyer eller breda vyer. Du kan definiera en fristående anpassad vy eller definiera en anpassad vy som används av en annan vy, till exempel en tabellvy eller listvy. Mer information om den här vyn finns i Anpassad vy.

Visa XML-element

I följande exempel visas de XML-taggar som används för att definiera en tabellvy som innehåller två kolumner. Elementet ViewDefinitions är containerelementet för alla vyer som definierats i formateringsfilen. View-elementet definierar den specifika tabellen, listan, bred eller anpassad vy. I varje vy anger elementet Namn namnet på vyn, elementet ViewSelectedBy definierar de objekt som använder vyn och de olika kontrollelementen (till exempel elementet) definierar vyns TableControl format.

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>

Se även

Tabellvy

Listvy

Bred vy

Anpassad vy

Skriva en Windows PowerShell-cmdlet