File di formattazione personalizzati

Il formato di visualizzazione per gli oggetti restituiti da cmdlet, funzioni e script viene definito usando file di formattazione ( fileformat.ps1xml). Molti di questi file vengono forniti da Windows PowerShell per definire il formato di visualizzazione predefinito per tali oggetti restituiti dai cmdlet di Windows PowerShell. Tuttavia, è anche possibile creare file di formattazione personalizzati per sovrascrivere i formati di visualizzazione predefiniti o per definire la visualizzazione degli oggetti restituiti dai propri comandi.

Windows PowerShell usa i dati in questi file di formattazione per determinare cosa viene visualizzato e come vengono formattati i dati. I dati visualizzati possono includere le proprietà di un oggetto o il valore di un blocco di script. I blocchi di script vengono usati se si desidera visualizzare un valore non disponibile direttamente dalle proprietà di un oggetto. Ad esempio, è possibile aggiungere il valore di due proprietà di un oggetto e visualizzare la somma come parte separata di dati. Quando si scrive un file di formattazione personalizzato, sarà necessario definire visualizzazioni per gli oggetti da visualizzare. È possibile definire una singola visualizzazione per ogni oggetto, è possibile definire una singola visualizzazione per più oggetti oppure definire più visualizzazioni per lo stesso oggetto. Non esiste alcun limite al numero di visualizzazioni che è possibile definire.

Importante

La formattazione dei file non determina gli elementi di un oggetto restituito alla pipeline. Quando viene restituito un oggetto alla pipeline, tutti i membri di tale oggetto sono disponibili.

Formattare le visualizzazioni

La formattazione delle visualizzazioni può visualizzare gli oggetti in un formato di tabella, un formato elenco, un formato wide e un formato personalizzato. Nella maggior parte dei casi, ogni definizione di formattazione viene descritta da un set di tag XML che descrivono una visualizzazione. Ogni vista contiene il nome della vista, gli oggetti che utilizzano la vista e gli elementi della vista, ad esempio le informazioni sulla colonna e sulla riga per una vista tabella.

Sono disponibili le visualizzazioni seguenti.

Visualizzazione Tabella Elenca le proprietà di un oggetto o un valore di blocco di script in una o più colonne. Ogni colonna rappresenta una proprietà dell'oggetto o di un valore di blocco di script. È possibile definire una vista tabella che visualizza tutte le proprietà di un oggetto, un subset delle proprietà di un oggetto o una combinazione di proprietà e valori di blocco di script. Ogni riga della tabella rappresenta un oggetto restituito. Per altre informazioni su questa vista, vedere Vista tabella.

Visualizzazione Elenco Elenca le proprietà di un oggetto o di un valore di blocco di script in una singola colonna. Ogni riga dell'elenco visualizza un'etichetta facoltativa o il nome della proprietà seguito dal valore della proprietà o del blocco di script. Per altre informazioni su questa visualizzazione, vedere Visualizzazione elenco.

Visualizzazione estesa Elenca una singola proprietà di un oggetto o un valore di blocco di script in una o più colonne. Non esiste alcuna etichetta o intestazione per questa visualizzazione. Per altre informazioni su questa vista, vedere visualizzazione wide.

Visualizzazione personalizzata Consente di visualizzare una visualizzazione personalizzabile delle proprietà degli oggetti o dei valori dei blocchi di script che non rispettano la struttura rigida delle visualizzazioni tabella, delle visualizzazioni elenco o delle visualizzazioni wide. È possibile definire una visualizzazione personalizzata autonoma oppure definire una visualizzazione personalizzata usata da un'altra visualizzazione, ad esempio una visualizzazione tabella o una visualizzazione elenco. Per altre informazioni su questa vista, vedere visualizzazione personalizzata.

Visualizzare elementi XML

Nell'esempio seguente vengono illustrati i tag XML utilizzati per definire una vista tabella contenente due colonne. L'elemento ViewDefinitions è l'elemento contenitore per tutte le visualizzazioni definite nel file di formattazione. L'elemento View definisce la tabella, l'elenco, l'wide o la visualizzazione personalizzata specifica. All'interno di ogni visualizzazione, l'elemento Name specifica il nome della visualizzazione, l'elemento ViewSelectedBy definisce gli oggetti che utilizzano la visualizzazione e i diversi elementi di controllo(ad esempio l'elemento TableControl) definiscono il formato della visualizzazione.

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>

Vedere anche

vista tabella

Visualizzazione Elenco

visualizzazione wide

visualizzazione personalizzata

scrittura di un cmdlet di Windows PowerShell