Custom Formatting Files (Personalizar Ficheiros de Formatação)

O formato de exibição para os objetos retornados por cmdlets, funções e scripts é definido usando arquivos de formatação (arquivosformat.ps1xml). Vários desses arquivos são fornecidos pelo Windows PowerShell para definir o formato de exibição padrão para esses objetos retornados pelos cmdlets do Windows PowerShell. No entanto, você também pode criar seus próprios arquivos de formatação personalizados para substituir os formatos de exibição padrão ou para definir a exibição de objetos retornados por seus próprios comandos.

O Windows PowerShell usa os dados nesses arquivos de formatação para determinar o que é exibido e como os dados são formatados. Os dados exibidos podem incluir as propriedades de um objeto ou o valor de um bloco de script. Os blocos de script são usados se você quiser exibir algum valor que não está disponível diretamente das propriedades de um objeto. Por exemplo, talvez você queira adicionar o valor de duas propriedades de um objeto e exibir a soma como uma parte separada de dados. Ao escrever seu próprio arquivo de formatação, você precisará definir modos de exibição para os objetos que deseja exibir. Você pode definir uma única exibição para cada objeto, você pode definir uma única exibição para vários objetos, ou você pode definir várias exibições para o mesmo objeto. Não há limite para o número de visualizações que você pode definir.

Importante

A formatação de arquivos não determina os elementos de um objeto que são retornados ao pipeline. Quando um objeto é retornado ao pipeline, todos os membros desse objeto ficam disponíveis.

Formatar vistas

Os modos de exibição de formatação podem exibir objetos em um formato de tabela, um formato de lista, um formato amplo e um formato personalizado. Na maioria das vezes, cada definição de formatação é descrita por um conjunto de marcas XML que descrevem uma exibição. Cada modo de exibição contém o nome do modo de exibição, os objetos que o usam e os elementos do modo de exibição, como as informações de coluna e linha para um modo de exibição de tabela.

Estão disponíveis as seguintes vistas.

Exibição de tabela Lista as propriedades de um objeto ou um valor de bloco de script em uma ou mais colunas. Cada coluna representa uma propriedade do objeto ou um valor de bloco de script. Você pode definir uma exibição de tabela que exibe todas as propriedades de um objeto, um subconjunto das propriedades de um objeto ou uma combinação de propriedades e valores de bloco de script. Cada linha da tabela representa um objeto retornado. Para obter mais informações sobre esse modo de exibição, consulte modo de exibição de tabela.

Modo de exibição de lista Lista as propriedades de um objeto ou um valor de bloco de script em uma única coluna. Cada linha da lista exibe um rótulo opcional ou o nome da propriedade seguido pelo valor da propriedade ou bloco de script. Para obter mais informações sobre esse modo de exibição, consulte modo de exibição de lista.

Modo de exibição amplo Lista uma única propriedade de um objeto ou um valor de bloco de script em uma ou mais colunas. Não há rótulo ou cabeçalho para esse modo de exibição. Para obter mais informações sobre esse modo de exibição, consulte Wide View.

Modo de exibição personalizado Exibe uma exibição personalizável de propriedades de objeto ou valores de bloco de script que não adere à estrutura rígida de modos de exibição de tabela, modos de exibição de lista ou modos de exibição amplos. Você pode definir um modo de exibição personalizado autônomo ou pode definir um modo de exibição personalizado que é usado por outro modo de exibição, como um modo de exibição de tabela ou de lista. Para obter mais informações sobre esse modo de exibição, consulte Modo de Exibição Personalizado.

Exibir elementos XML

O exemplo a seguir mostra as marcas XML usadas para definir um modo de exibição de tabela que contém duas colunas. O elemento ViewDefinitions é o elemento container para todas as exibições definidas no arquivo de formatação. O elemento View define a tabela, lista, ampla ou exibição personalizada específica. Em cada modo de exibição, o elemento Name especifica o nome do modo de exibição, o elemento ViewSelectedBy define os objetos que usam o modo de exibição e os diferentes elementos de controle (como o elemento TableControl) definem o formato do modo de exibição.

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>

Ver também

de Visualização de Tabela

Vista de Lista

Wide View

Modo de Exibição Personalizado

Escrevendo um cmdlet do Windows PowerShell