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 cmdlet Update-FormatData ricarica i dati di formattazione dai file di formattazione nella sessione corrente. Consente di aggiornare i dati di formattazione senza riavviare Windows 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 in formato XML con estensione format.ps1xml. I dati di formattazione dei file definiscono la visualizzazione degli oggetti Microsoft .NET Framework nella sessione.

All'avvio, Windows PowerShell carica nella sessione i dati dei formati dai file di formattazione della directory di installazione di Windows PowerShell ($pshome). È possibile usare Update-FormatData per ricaricare i dati di formattazione nella sessione corrente senza riavviare Windows PowerShell. Questa funzione è utile se è stato aggiunto o modificato un file di formattazione ma non si vuole interrompere la sessione.

Per altre informazioni sui file di formattazione 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 file di formattazione e 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 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

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

# Edit the NewFiles.format.ps1 file.

PS C:\> 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 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 usare i parametri.

Parametri

-AppendPath

Specifica la formattazione dei file aggiunti al cmdlet alla sessione. I file vengono caricati dopo che Windows PowerShell carica i file di formattazione predefiniti.

Quando si formattano oggetti .NET, Windows PowerShell usa la prima definizione di formattazione che trova per ogni tipo .NET. Se si usa il parametro AppendPath, Windows PowerShell cerca i 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 Windows PowerShell carica i file di formattazione predefiniti.

Quando si formattano oggetti .NET, Windows PowerShell usa la prima definizione di formattazione che trova per ogni tipo .NET. Se si usa il parametro PrependPath, Windows PowerShell cerca i dati dai file aggiunti prima di riscontrare 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.

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 Update-FormatData.

Output

None

Questo cmdlet non restituisce alcun output.

Note

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