Compartir a través de

Vista de lista (GroupBy)

En este ejemplo se muestra cómo implementar una vista de lista que separa las filas de la lista en grupos. En esta vista de lista se muestran las propiedades de los objetos de System.ServiceProcess.ServiceController devueltos por el cmdlet get-service de. Para obtener más información sobre los componentes de una vista de lista, vea Crear una vista de lista.

Cargar este archivo de formato

  1. Copie el XML de la sección Ejemplo de este tema en un archivo de texto.

  2. Guarde el archivo de texto. Asegúrese de agregar la extensión format.ps1xml al archivo para identificarla como un archivo de formato.

  3. Abra Windows PowerShell y ejecute el siguiente comando para cargar el archivo de formato en la sesión actual: Update-FormatData -PrependPath PathToFormattingFile.

Advertencia

Este archivo de formato define la presentación de un objeto que ya está definido por un archivo de formato de Windows PowerShell. Debe usar el parámetro PrependPath al ejecutar el cmdlet y no puede cargar este archivo de formato como módulo.

Demostraciones

Este archivo de formato muestra los siguientes elementos XML:

  • Elemento Name de la vista.

  • El elemento ViewSelectedBy que define los objetos que muestra la vista.

  • El elemento GroupBy que define cómo se muestra un nuevo grupo de objetos.

  • El elemento ListControl que define la propiedad que muestra la vista.

  • El elemento ListItem que define lo que se muestra en una fila de la vista de lista.

  • El elemento PropertyName que define qué propiedad se muestra.

Ejemplo

El siguiente XML define una vista de lista que inicia un nuevo grupo cada vez que cambia el valor de la propiedad System.ServiceProcess.ServiceController.Status. Cuando se inicia cada grupo, se muestra una etiqueta personalizada que incluye el nuevo valor de la propiedad.

<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>

En el ejemplo siguiente se muestra cómo Windows PowerShell muestra los objetos System.ServiceProcess.ServiceController después de cargar este archivo de formato. Windows PowerShell agrega automáticamente las líneas en blanco antes y después de agregar la etiqueta de grupo.

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

Véase también

ejemplos de archivos de formato

Escritura de un archivo de formato de PowerShell

  • Last updated on