Anpassade formateringsfiler

Visningsformatet för de objekt som returneras av cmdletar, funktioner och skript definieras med 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-cmdletar. Du kan dock också skapa egna anpassade formateringsfiler för att skriva över standardvisningsformaten eller för att definiera visning av objekt som returneras av dina egna kommandon.

Windows PowerShell använder data i dessa formateringsfiler för att avgöra vad som visas och hur data formateras. De 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 datadel. När du skriver en egen formateringsfil måste du definiera vyer för de objekt som du vill visa. Du kan definiera en enda vy för varje objekt, du kan 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 du kan definiera.

Viktigt!

Formateringsfiler 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.

Formatera vyer

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

Följande vyer är tillgängliga.

Tabellvy Visar 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 Visar 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 Wide View.

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 så kan du 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. Elementet View definierar den specifika tabellen, listan, den breda eller anpassade vyn. I varje vy anger elementet Name namnet på vyn, elementet ViewSelectedBy definierar de objekt som använder vyn och de olika kontrollelementen (till exempel TableControl-elementet) definierar formatet för vyn.

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

Wide View

anpassad vy

Skriva en Windows PowerShell-cmdlet