Condividi tramite


Visualizzazione elenco (GroupBy)

In questo esempio viene illustrato come implementare una visualizzazione elenco che separa le righe dell'elenco in gruppi. In questa visualizzazione elenco vengono visualizzate le proprietà degli oggetti System.ServiceProcess.ServiceController restituiti dal cmdlet Get-Service. Per altre informazioni sui componenti di una visualizzazione elenco, vedere Creazione di una visualizzazione elenco.

Caricare questo file di formattazione

  1. Copiare il codice XML dalla sezione Esempio di questo argomento in un file di testo.

  2. Salvare il file di testo. Assicurarsi di aggiungere l'estensione format.ps1xml al file per identificarla come file di formattazione.

  3. Aprire Windows PowerShell ed eseguire il comando seguente per caricare il file di formattazione nella sessione corrente: Update-FormatData -PrependPath PathToFormattingFile.

Avvertimento

Questo file di formattazione definisce la visualizzazione di un oggetto già definito da un file di formattazione di Windows PowerShell. È necessario usare il parametro PrependPath quando si esegue il cmdlet e non è possibile caricare questo file di formattazione come modulo.

Dimostra

Questo file di formattazione illustra gli elementi XML seguenti:

  • Elemento Nome per la visualizzazione.

  • Elemento ViewSelectedBy che definisce gli oggetti visualizzati dalla visualizzazione.

  • Elemento GroupBy che definisce la modalità di visualizzazione di un nuovo gruppo di oggetti.

  • Elemento listControl che definisce la proprietà visualizzata dalla visualizzazione.

  • Elemento ListItem che definisce ciò che viene visualizzato in una riga della visualizzazione elenco.

  • Elemento PropertyName che definisce la proprietà visualizzata.

Esempio

Il codice XML seguente definisce una visualizzazione elenco che avvia un nuovo gruppo ogni volta che cambia il valore della proprietà System.ServiceProcess.ServiceController.Status. All'avvio di ogni gruppo, viene visualizzata un'etichetta personalizzata che include il nuovo valore della proprietà.

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

Nell'esempio seguente viene illustrato come Windows PowerShell visualizzi gli oggetti System.ServiceProcess.ServiceController dopo il caricamento di questo file di formato. Le righe vuote aggiunte prima e dopo l'etichetta di gruppo vengono aggiunte automaticamente da 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

Vedere anche

esempi di formattazione dei file

La Scrittura di un File di Formattazione di PowerShell