Niestandardowe pliki formatujące

Format wyświetlania obiektów zwracanych przez polecenia cmdlet, funkcje i skrypty są definiowane przy użyciu plików formatowania (format.ps1xml plików). Kilka z tych plików jest dostarczanych przez program Windows PowerShell, aby zdefiniować domyślny format wyświetlania dla tych obiektów zwracanych przez polecenia cmdlet programu Windows PowerShell. Można jednak również utworzyć własne niestandardowe pliki formatowania, aby zastąpić domyślne formaty wyświetlania lub zdefiniować wyświetlanie obiektów zwracanych przez własne polecenia.

Program Windows PowerShell używa danych w tych plikach formatowania, aby określić, co jest wyświetlane i jak są sformatowane dane. Wyświetlane dane mogą zawierać właściwości obiektu lub wartość bloku skryptu. Bloki skryptu są używane, jeśli chcesz wyświetlić pewną wartość, która nie jest dostępna bezpośrednio z właściwości obiektu. Na przykład możesz dodać wartość dwóch właściwości obiektu i wyświetlić sumę jako oddzielny fragment danych. Podczas pisania własnego pliku formatowania należy zdefiniować widoki dla obiektów, które mają być wyświetlane. Można zdefiniować pojedynczy widok dla każdego obiektu, można zdefiniować pojedynczy widok dla wielu obiektów lub zdefiniować wiele widoków dla tego samego obiektu. Nie ma limitu liczby widoków, które można zdefiniować.

Ważne

Pliki formatowania nie określają elementów obiektu, które są zwracane do potoku. Gdy obiekt zostanie zwrócony do potoku, są dostępne wszystkie elementy członkowskie tego obiektu.

Formatowanie widoków

Widoki formatowania mogą wyświetlać obiekty w formacie tabeli, formacie listy, formacie szerokim i formacie niestandardowym. W większości przypadków każda definicja formatowania jest opisana przez zestaw tagów XML opisujących widok. Każdy widok zawiera nazwę widoku, obiekty korzystające z widoku oraz elementy widoku, takie jak kolumna i informacje o wierszu widoku.

Dostępne są następujące widoki.

Widok tabeli Wyświetla właściwości obiektu lub wartości bloku skryptu w co najmniej jednej kolumnie. Każda kolumna reprezentuje właściwość obiektu lub wartość bloku skryptu. Można zdefiniować widok tabeli, który wyświetla wszystkie właściwości obiektu, podzestaw właściwości obiektu lub kombinację właściwości i wartości bloków skryptu. Każdy wiersz tabeli reprezentuje zwrócony obiekt. Aby uzyskać więcej informacji na temat tego widoku, zobacz Widok tabeli.

Widok listy Wyświetla właściwości obiektu lub wartości bloku skryptu w jednej kolumnie. Każdy wiersz listy wyświetla opcjonalną etykietę lub nazwę właściwości, po której następuje wartość bloku właściwości lub skryptu. Aby uzyskać więcej informacji na temat tego widoku, zobacz Widok listy.

Widok szeroki Wyświetla pojedynczą właściwość obiektu lub wartości bloku skryptu w co najmniej jednej kolumnie. Brak etykiety ani nagłówka dla tego widoku. Aby uzyskać więcej informacji na temat tego widoku, zobacz Wide View.

Widok niestandardowy Wyświetla dostosowywalny widok właściwości obiektu lub wartości bloków skryptu, które nie są zgodne ze sztywną strukturą widoków tabeli, widoków listy lub szerokich widoków. Możesz zdefiniować autonomiczny widok niestandardowy lub zdefiniować widok niestandardowy używany przez inny widok, taki jak widok tabeli lub widok listy. Aby uzyskać więcej informacji na temat tego widoku, zobacz Widok niestandardowy.

Wyświetlanie elementów XML

W poniższym przykładzie przedstawiono tagi XML używane do definiowania widoku tabeli zawierającego dwie kolumny. Element ViewDefinitions jest elementem kontenera dla wszystkich widoków zdefiniowanych w pliku formatowania. Element View definiuje określoną tabelę, listę, szeroki lub niestandardowy widok. W każdym widoku element nazwa określa nazwę widoku, element ViewSelectedBy definiuje obiekty używające widoku, a różne elementy kontrolki (takie jak element TableControl) definiują format widoku.

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>

Zobacz też

widoku tabeli

widok listy

widoku szerokiego

widoku niestandardowego

pisanie polecenia cmdlet programu Windows PowerShell