Condividi tramite

Update-FormatData

Modulo:
Microsoft.PowerShell.Utility Module

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

Senza parametri, Update-FormatData ricarica i file di formattazione caricati in precedenza. È possibile usare 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 l'estensione del nome file format.ps1xml. La formattazione dei dati nei file definisce la visualizzazione degli oggetti di Microsoft .NET Framework nella sessione.

All'avvio di Windows PowerShell, carica i dati di formato dai file di formattazione nella directory di installazione di PowerShell ($PSHOME) nella sessione. È possibile usare Update-FormatData per ricaricare i dati di formattazione nella sessione corrente senza riavviare PowerShell. Ciò è utile quando è stato aggiunto o modificato un file di formattazione, ma non si vuole interrompere la sessione.

Per altre informazioni sulla formattazione dei file in PowerShell, vedere about_Format.ps1xml.

Esempio

Esempio 1: Ricaricare i file di formattazione caricati in precedenza

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

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

Update-FormatData -PrependPath "C:\test\NewFiles.format.ps1xml"

# Edit the NewFiles.format.ps1 file.

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 testarlo in queste sessioni, l'autore modifica il file.

Il secondo comando usa il cmdlet Update-FormatData per ricaricare i file di formattazione. Poiché il file NewFiles.format.ps1xml è stato caricato in precedenza, Update-FormatData ricaricarlo automaticamente senza usare parametri.

Parametri

-AppendPath

Specifica i file di formattazione aggiunti da questo cmdlet alla sessione. I file vengono caricati dopo che PowerShell carica i file di formattazione predefiniti.

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 PowerShell carichi i file di formattazione predefiniti.

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 inviare tramite pipe una stringa contenente il percorso di accodamento a questo cmdlet.

Output

None

Questo cmdlet non restituisce alcun output.

Note

  • Update-FormatData aggiorna anche i dati di formattazione per i comandi nella sessione importata dai moduli. Se il file di formattazione per un modulo cambia, è possibile eseguire un comando Update-FormatData per aggiornare i dati di formattazione per i comandi importati. Non è necessario importare di nuovo il modulo.