Update-FormatData
Aggiorna i dati di formattazione della sessione corrente.
Sintassi
Update-FormatData [[-AppendPath] <string[]>] [-PrependPath <string[]>] [-Confirm] [-WhatIf] [<CommonParameters>]
Descrizione
Il cmdlet Update-FormatData ricarica i dati di formattazione dai file di formattazione nella sessione corrente. Questo cmdlet consente di aggiornare i dati di formattazione senza riavviare Windows PowerShell.
Senza parametri, Update-FormatData ricarica i file di formattazione precedentemente caricati. È possibile utilizzare i parametri di Update-FormatData per aggiungere i nuovi file di formattazione alla sessione.
I file di formattazione sono file di testo in formato XML con estensione ps1xml. I dati di formattazione nei file definiscono la visualizzazione degli oggetti Microsoft .NET Framework nella sessione.
All'avvio di Windows PowerShell, i dati relativi al formato vengono caricati dai file di formattazione della directory di installazione di Windows PowerShell ($pshome) nella sessione. È possibile utilizzare Update-FormatData per ricaricare i dati di formattazione nella sessione corrente senza riavviare Windows PowerShell. Ciò si rivela utile quando è stato aggiunto o modificato un file di formattazione, ma non si desidera interrompere la sessione.
Per ulteriori informazioni sui file di formattazione in Windows PowerShell, vedere about_Format.ps1xml.
Parametri
-AppendPath <string[]>
Aggiunge i file di formattazione specificati alla sessione. I file vengono caricati dopo il caricamento dei file di formattazione predefiniti da parte di Windows PowerShell.
In caso di formattazione di oggetti .NET, viene utilizzata la prima definizione di formattazione trovata per ogni tipo .NET. Se si utilizza il parametro AppendPath, Windows PowerShell esegue la ricerca dei dati presenti nei file predefiniti prima di rilevare i dati di formattazione aggiunti.
Utilizzare questo parametro per aggiungere un file che consente di formattare un oggetto .NET al quale non viene fatto riferimento nei file di formattazione predefiniti.
Obbligatorio? |
false |
Posizione? |
1 |
Valore predefinito |
|
Accettare input da pipeline? |
true (ByValue, ByPropertyName) |
Accettare caratteri jolly? |
false |
-PrependPath <string[]>
Aggiunge i file di formattazione specificati alla sessione. I file vengono caricati prima del caricamento dei file di formattazione predefiniti da parte di Windows PowerShell.
In caso di formattazione di oggetti .NET, viene utilizzata la prima definizione di formattazione trovata per ogni tipo .NET. Se si utilizza il parametro AppendPath, Windows PowerShell esegue la ricerca dei dati presenti nei file aggiunti prima di rilevare i dati di formattazione presenti nei file predefiniti.
Utilizzare questo parametro per aggiungere un file che consente di formattare un oggetto .NET al quale viene fatto riferimento anche nei file di formattazione predefiniti.
Obbligatorio? |
false |
Posizione? |
named |
Valore predefinito |
|
Accettare input da pipeline? |
false |
Accettare caratteri jolly? |
false |
-Confirm
Chiede una conferma prima di eseguire il comando.
Obbligatorio? |
false |
Posizione? |
named |
Valore predefinito |
|
Accettare input da pipeline? |
false |
Accettare caratteri jolly? |
false |
-WhatIf
Descrive ciò che accadrebbe se si eseguisse il comando senza eseguirlo realmente.
Obbligatorio? |
false |
Posizione? |
named |
Valore predefinito |
|
Accettare input da pipeline? |
false |
Accettare caratteri jolly? |
false |
<CommonParameters>
Questo cmdlet supporta i parametri comuni -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Per ulteriori informazioni, vedere about_Commonparameters.
Input e output
Il tipo di input è il tipo degli oggetti che è possibile reindirizzare al cmdlet. Il tipo restituito è il tipo degli oggetti restituiti dal cmdlet.
Input |
System.String È possibile reindirizzare una stringa che contiene un percorso aggiunto a Update-FormatData. |
Output |
Nessuno Il cmdlet non restituisce alcun output. |
Note
Update-FormatData aggiorna anche i dati di formattazione per i comandi nella sessione importati dai moduli. Se viene modificato il file di formattazione di un modulo, è possibile eseguire un comando Update-FormatData per aggiornare i dati di formattazione per i comandi importati. Non è necessario importare nuovamente il modulo.
Esempio 1
C:\PS>update-formatdata
Descrizione
-----------
Questo comando ricarica i file di formattazione precedentemente caricati.
Esempio 2
C:\PS>update-formatdata -appendpath trace.format.ps1xml, log.format.ps1xml
Descrizione
-----------
Questo comando ricarica i file di formattazione nella sessione, inclusi due nuovi file, Trace.format.ps1xml e Log.format.ps1xml.
Poiché il comando utilizza il parametro AppendPath, i dati di formattazione presenti nei nuovi file vengono caricati dopo i dati di formattazione presenti nei file predefiniti.
Viene utilizzato il parametro AppendPath poiché i nuovi file contengono dati di formattazione per oggetti a cui non viene fatto riferimento nei file predefiniti.
Esempio 3
C:\PS>update-formatdata -prependPath c:\test\NewFiles.format.ps1xml
# Edit the NewFiles.format.ps1 file.
C:\PS> update-formatdata
Descrizione
-----------
In questo esempio viene illustrato come ricaricare un file di formattazione dopo averlo modificato.
Con il primo comando viene aggiunto il file NewFiles.format.ps1xml alla sessione. Viene utilizzato il parametro PrependPath poiché il file contiene dati di formattazione per oggetti a cui non viene fatto riferimento nei file predefiniti.
Dopo aver aggiunto il file NewFiles.format.ps1xml e averlo verificato in questa sessione, l'autore modifica il file.
Nel secondo comando viene utilizzato il cmdlet Update-FormatData per ricaricare i file di formattazione. Poiché il file NewFiles.format.ps1xml è stato caricato precedentemente, Update-FormatData lo ricarica automaticamente senza utilizzare parametri.