Condividi tramite

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.

La formattazione dei file è file di testo in formato XML con l'estensione del format.ps1xml 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 di formato.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 file di formattazione e 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 usato perché i nuovi file contengono dati di formattazione per gli oggetti non a cui 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 testarlo 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 i parametri.

Parametri

-AppendPath

Specifica la formattazione dei file aggiunti al 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 che trova per ogni tipo .NET. Se si usa il parametro AppendPath , PowerShell esegue la ricerca dei dati dai file predefiniti prima di riscontrare 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 la conferma dell'utente 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 la formattazione dei file aggiunti al 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 che trova per ogni tipo .NET. Se si usa il parametro PrependPath , PowerShell esegue la ricerca dei dati dai file aggiunti prima di riscontrare 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 l'esito in caso di 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 una pipe a 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.