Arquivos de formatação personalizada

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 os 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 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 serão usados se você quiser exibir algum valor que não esteja 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 dos dados. Ao escrever seu próprio arquivo de formatação, você precisará definir exibições para os objetos que deseja exibir. Você pode definir uma única exibição para cada objeto, definir uma única exibição para vários objetos ou definir várias exibições para o mesmo objeto. Não há limite para o número de exibições que você pode definir.

Importante

Os arquivos de formatação não determinam os elementos de um objeto que são retornados para o pipeline. Quando um objeto é retornado ao pipeline, todos os membros desse objeto estão disponíveis.

Formatar exibições

Exibições de formatação podem exibir objetos em um formato de tabela, um formato de lista, um formato largo 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 exibição contém o nome da exibição, os objetos que usam a exibição e os elementos da exibição, como as informações de coluna e linha de um modo de exibição de tabela.

As exibições a seguir estão disponíveis.

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 Exibição de Tabela.

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 essa exibição, consulte Exibição de Lista.

Exibição ampla Lista uma única propriedade de um objeto ou um valor de bloco de script em uma ou mais colunas. Não há nenhum 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.

Exibição personalizada Exibe uma exibição personalizável de propriedades de objeto ou valores de bloco de script que não aderem à estrutura rígida de exibições de tabela, exibições de lista ou exibições amplas. Você pode definir uma exibição personalizada autônoma ou definir uma exibição personalizada usada por outra exibição, como um modo de exibição de tabela ou exibição de lista. Para obter mais informações sobre essa exibição, consulte Modo de Exibição Personalizado.

Exibir elementos XML

O exemplo a seguir mostra as marcas XML usadas para definir uma exibição de tabela que contém duas colunas. O elemento ViewDefinitions é o elemento de contêiner para todas as exibições definidas no arquivo de formatação. O elemento View define a tabela, a lista, a ampla ou a exibição personalizada específica. Em cada exibição, o elemento Name especifica o nome da exibição, o elemento ViewSelectedBy define os objetos que usam a exibição e os diferentes elementos de controle (como o elemento TableControl) definem o formato da 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>

Consulte Também

exibição de tabela

Exibição de Lista

do Wide View

modo de exibição personalizado

gravando um cmdlet do Windows PowerShell