Partilhar via

List View (GroupBy) (Vista de Lista [GroupBy])

Este exemplo mostra como implementar um modo de exibição de lista que separa as linhas da lista em grupos. Esta exibição de lista exibe as propriedades dos objetos System.ServiceProcess.ServiceController retornados pelo cmdlet Get-Service. Para obter mais informações sobre os componentes de um modo de exibição de lista, consulte Criando um modo de exibição de lista.

Carregue este ficheiro de formatação

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

  2. Guarde o ficheiro de texto. Certifique-se de adicionar a extensão format.ps1xml ao arquivo para identificá-lo 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.

Advertência

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 ficheiro de formatação demonstra os seguintes elementos XML:

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

  • O ViewSelectedBy elemento que define quais objetos são exibidos pelo modo de exibição.

  • O GroupBy elemento que define como um novo grupo de objetos é exibido.

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

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

  • O PropertyName elemento que define qual propriedade é exibida.

Exemplo

O XML a seguir define um modo de exibição de lista que inicia um novo grupo sempre que o valor da propriedade System.ServiceProcess.ServiceController.Status é alterado. Quando cada grupo é iniciado, um rótulo personalizado é exibido que inclui o novo valor da propriedade.

<Configuration>
  <ViewDefinitions>
    <View>
      <Name>System.ServiceProcess.ServiceController</Name>
      <ViewSelectedBy>
        <TypeName>System.ServiceProcess.ServiceController</TypeName>
      </ViewSelectedBy>
      <GroupBy>
        <PropertyName>Status</PropertyName>
        <Label>New Service Status</Label>
      </GroupBy>
      <ListControl>
        <ListEntries>
          <ListEntry>
            <ListItems>
              <ListItem>
                <PropertyName>Name</PropertyName>
              </ListItem>
              <ListItem>
                <PropertyName>DisplayName</PropertyName>
              </ListItem>
              <ListItem>
                <PropertyName>ServiceType</PropertyName>
              </ListItem>
            </ListItems>
          </ListEntry>
        </ListEntries>
      </ListControl>
    </View>
  </ViewDefinitions>
</Configuration>

O exemplo a seguir mostra como o Windows PowerShell exibe o objetos System.ServiceProcess.ServiceController depois que esse arquivo de formato é carregado. As linhas em branco adicionadas antes e depois do rótulo do grupo são adicionadas automaticamente pelo Windows PowerShell.

Get-Service f*

   New Service Status: Stopped

Name        : Fax
DisplayName : Fax
ServiceType : Win32OwnProcess

   New Service Status: Running

Name        : FCSAM
DisplayName : Microsoft Antimalware Service
ServiceType : Win32OwnProcess

   New Service Status: Stopped

Name        : fdPHost
DisplayName : Function Discovery Provider Host
ServiceType : Win32ShareProcess

   New Service Status: Running

Name        : FDResPub
DisplayName : Function Discovery Resource Publication
ServiceType : Win32ShareProcess

Name        : FontCache
DisplayName : Windows Font Cache Service
ServiceType : Win32ShareProcess

   New Service Status: Stopped

Name        : FontCache3.0.0.0
DisplayName : Windows Presentation Foundation Font Cache 3.0.0.0
ServiceType : Win32OwnProcess

   New Service Status: Running

Name        : FSysAgent
DisplayName : Microsoft Forefront System Agent
ServiceType : Win32OwnProcess

Name        : FwcAgent
DisplayName : Firewall Client Agent
ServiceType : Win32OwnProcess

Ver também

exemplos de formatação de arquivos

Escrevendo um arquivo de formatação do PowerShell

  • Last updated on