Update-FormatData
Aggiorna i dati di formattazione nella sessione corrente.
Sintassi
Default (Impostazione predefinita)
Update-FormatData
[[-AppendPath] <String[]>]
[-PrependPath <String[]>]
[-WhatIf]
[-Confirm]
[<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 caricati in precedenza. È possibile utilizzare i parametri di Update-FormatData per aggiungere nuovi file di formattazione alla sessione.
I file di formattazione sono file di testo in formato XML con estensione format.ps1xml. La formattazione dei dati nei file definisce la visualizzazione degli oggetti di Microsoft .NET Framework nella sessione.
All'avvio, Windows PowerShell carica i dati di formattazione dai file di formattazione nella 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ò è utile quando è stato aggiunto o modificato un file di formattazione, ma non si vuole interrompere la sessione.
Per ulteriori informazioni sulla formattazione dei file in Windows PowerShell, vedere about_Format.ps1xml.
Esempio
Esempio 1: Ricaricare i file di formattazione caricati in precedenza
PS C:\> Update-FormatData
Questo comando ricarica i file di formattazione caricati in precedenza.
Esempio 2: Ricaricare i file di formattazione e i file di traccia e formattazione dei log
PS C:\> Update-FormatData -AppendPath "trace.format.ps1xml, log.format.ps1xml"
Questo comando ricarica i file di formattazione nella sessione, inclusi due nuovi file, Trace.format.ps1xml e Log.format.ps1xml.
Poiché il comando usa il parametro appendPath, i dati di formattazione nei nuovi file vengono caricati dopo la formattazione dei dati dai file predefiniti.
Il parametro AppendPath viene utilizzato perché i nuovi file contengono dati di formattazione per gli oggetti a cui non si fa riferimento nei file predefiniti.
Esempio 3: Modificare un file di formattazione e ricaricarlo
PS C:\> Update-FormatData -PrependPath "c:\test\NewFiles.format.ps1xml"
# Edit the NewFiles.format.ps1 file.
PS C:\> Update-FormatData
In questo esempio viene illustrato come ricaricare un file di formattazione dopo averlo modificato.
Il primo comando aggiunge il file NewFiles.format.ps1xml alla sessione. Usa il parametro PrependPath perché il file contiene dati di formattazione per gli oggetti a cui si fa riferimento nei file predefiniti.
Dopo aver aggiunto il file NewFiles.format.ps1xml e averla testata in queste sessioni, l'autore modifica il file.
Il secondo comando utilizza il cmdlet Update-FormatData per ricaricare i file di formattazione. Poiché il file NewFiles.format.ps1xml è stato caricato in precedenza, Update-FormatData lo ricarica automaticamente senza utilizzare parametri.
Parametri
-AppendPath
Specifica i file di formattazione aggiunti da questo cmdlet alla sessione. I file vengono caricati dopo che Windows PowerShell ha caricato i file di formattazione incorporati.
Quando si formattano oggetti .NET, Windows PowerShell usa la prima definizione di formattazione trovata per ogni tipo .NET. Se si usa il parametro AppendPath, Windows PowerShell cerca i dati dai file predefiniti prima di incontrare i dati di formattazione aggiunti.
Usare questo parametro per aggiungere un file che formatta un oggetto .NET a cui non viene fatto riferimento nei file di formattazione predefiniti.
Proprietà dei parametri
| Tipo: | String[] |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | PSPath, Percorso |
Set di parametri
(All)
| Posizione: | 0 |
| Obbligatorio: | False |
| Valore dalla pipeline: | True |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
-Confirm
Richiede conferma prima di eseguire il cmdlet.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | False |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | cfr |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-PrependPath
Specifica i file di formattazione aggiunti da questo cmdlet alla sessione. I file vengono caricati prima che Windows PowerShell carichi i file di formattazione incorporati.
Quando si formattano oggetti .NET, Windows PowerShell usa la prima definizione di formattazione trovata per ogni tipo .NET. Se si usa il parametro PrependPath, Windows PowerShell esegue una ricerca nei dati dei file aggiunti prima che vengano visualizzati i dati di formattazione dai file predefiniti.
Usare questo parametro per aggiungere un file che formatta un oggetto .NET a cui viene fatto riferimento anche nei file di formattazione predefiniti.
Proprietà dei parametri
| Tipo: | String[] |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-WhatIf
Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | False |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | Wi |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
CommonParameters
Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.
Input
String
È possibile reindirizzare una stringa che contiene il percorso di aggiunta a Update-FormatData.
Output
None
Il cmdlet non restituisce alcun output.
Note
Update-FormatData aggiorna inoltre i dati di formattazione per i comandi della sessione importati dai moduli. Se il file di formattazione di un modulo viene modificato, è possibile eseguire un comando Update-FormatData per aggiornare i dati di formattazione per i comandi importati. Non è necessario importare di nuovo il modulo.