Compartilhar via


Exibição de lista (rótulos)

Este exemplo mostra como implementar uma exibição de lista que exibe um rótulo personalizado para cada linha da lista. Esta exibição de lista exibe as propriedades do objeto System.ServiceProcess.ServiceController que é retornado pelo cmdlet Get-Service. Para obter mais informações sobre os componentes de uma exibição de lista, consulte Criando uma exibição de lista.

Carregar este arquivo de formatação

  1. Copie o XML da seção Exemplo deste tópico em um arquivo de texto.

  2. Salve o arquivo de texto. Adicione a extensão format.ps1xml ao arquivo para identificá-la como um arquivo de formatação.

  3. Abra o Windows PowerShell e execute o seguinte comando para carregar o arquivo de formatação na sessão atual: Update-FormatData -PrependPath PathToFormattingFile.

Aviso

Esse arquivo de formatação define a exibição de um objeto que já está definido por um arquivo de formatação do Windows PowerShell. Você deve usar o parâmetro PrependPath ao executar o cmdlet e não pode carregar esse arquivo de formatação como um módulo.

Demonstra

Este arquivo de formatação demonstra os seguintes elementos XML:

  • O elemento Name para o modo de exibição.

  • O elemento ViewSelectedBy que define quais objetos são exibidos pela exibição.

  • O elemento ListControl que define qual propriedade é exibida pelo modo de exibição.

  • O elemento ListItem que define o que é exibido em uma linha do modo de exibição de lista.

  • O elemento Label que define o que é exibido em uma linha do modo de exibição de lista.

  • O elemento PropertyName que define qual propriedade é exibida.

Exemplo

O XML a seguir define uma exibição de lista que exibe um rótulo personalizado em cada linha. Nesse caso, o rótulo inclui o nome da propriedade com cada letra maiúscula e a palavra "propriedade". Em cada linha, o nome da propriedade é exibido seguido pelo valor da propriedade.

<Configuration>
  <ViewDefinitions>
    <View>
  <Name>System.ServiceProcess.ServiceController</Name>
  <ViewSelectedBy>
    <TypeName>System.ServiceProcess.ServiceController</TypeName>
  </ViewSelectedBy>
  <ListControl>
    <ListEntries>
      <ListEntry>
        <ListItems>
          <ListItem>
            <Label>NAME property</Label>
            <PropertyName>Name</PropertyName>
          </ListItem>
          <ListItem>
            <Label>DISPLAYNAME property</Label>
            <PropertyName>DisplayName</PropertyName>
          </ListItem>
          <ListItem>
            <Label>STATUS property</Label>
            <PropertyName>Status</PropertyName>
          </ListItem>
          <ListItem>
            <Label>SERVICETYPE property</Label>
            <PropertyName>ServiceType</PropertyName>
          </ListItem>
        </ListItems>
      </ListEntry>
    </ListEntries>
  </ListControl>
</View>

  </ViewDefinitions>
</Configuration>

O exemplo a seguir mostra como o Windows PowerShell exibe os objetos System.ServiceProcess.ServiceController depois que esse arquivo de formato é carregado.

Get-Service f*
NAME property        : Fax
DISPLAYNAME property : Fax
STATUS property      : Stopped
SERVICETYPE property : Win32OwnProcess

NAME property        : FCSAM
DISPLAYNAME property : Microsoft Antimalware Service
STATUS property      : Running
SERVICETYPE property : Win32OwnProcess

NAME property        : fdPHost
DISPLAYNAME property : Function Discovery Provider Host
STATUS property      : Stopped
SERVICETYPE property : Win32ShareProcess

NAME property        : FDResPub
DISPLAYNAME property : Function Discovery Resource Publication
STATUS property      : Running
SERVICETYPE property : Win32ShareProcess

NAME property        : FontCache
DISPLAYNAME property : Windows Font Cache Service
STATUS property      : Running
SERVICETYPE property : Win32ShareProcess

NAME property        : FontCache3.0.0.0
DISPLAYNAME property : Windows Presentation Foundation Font Cache 3.0.0.0
STATUS property      : Stopped
SERVICETYPE property : Win32OwnProcess

NAME property        : FSysAgent
DISPLAYNAME property : Microsoft Forefront System Agent
STATUS property      : Running
SERVICETYPE property : Win32OwnProcess

NAME property        : FwcAgent
DISPLAYNAME property : Firewall Client Agent
STATUS property      : Running
SERVICETYPE property : Win32OwnProcess

Consulte Também

exemplos de arquivos de formatação

Criando um arquivo de formatação do PowerShell