Update-FormatData

  • Riferimento
Modulo:
Microsoft.PowerShell.Utility

Aggiorna i dati di formattazione della sessione corrente.

Sintassi

Update-FormatData
      [[-AppendPath] <String[]>]
      [-PrependPath <String[]>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Descrizione

Il Update-FormatData cmdlet 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 per aggiungere nuovi file di Update-FormatData formattazione alla sessione.

I file di formattazione sono file di testo in formato XML con l'estensione format.ps1xml del nome file. I dati di formattazione dei file definiscono la visualizzazione degli oggetti Microsoft .NET Framework nella sessione.

All'avvio di PowerShell, carica i dati di formato dal codice sorgente di PowerShell. Tuttavia, è possibile creare file format.ps1xml personalizzati per aggiornare la formattazione nella sessione corrente. È possibile usare Update-FormatData per ricaricare i dati di formattazione nella sessione corrente senza riavviare PowerShell. Questa funzione è utile se è 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

Questo esempio illustra come ricaricare un file di formattazione dopo che è stato 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 usa il Update-FormatData cmdlet per ricaricare i file di formattazione. Poiché il file NewFiles.format.ps1xml è stato caricato in precedenza, Update-FormatData lo ricarica 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, PowerShell usa la prima definizione di formattazione trovata per ogni tipo .NET. Se si usa il parametro AppendPath , 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.

Type:String[]
Aliases:PSPath, Path
Position:0
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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, PowerShell usa la prima definizione di formattazione trovata per ogni tipo .NET. Se si usa il parametro PrependPath , PowerShell cerca i dati dai file aggiunti prima di incontrare i dati di formattazione dei 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.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Input

String

È possibile inviare tramite pipe una stringa contenente il percorso di accodamento a questo cmdlet.

Output

None

Questo cmdlet non restituisce output.

Note

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