Format-Custom
Usa una visualizzazione personalizzata per formattare l'output.
Sintassi
Format-Custom
[[-Property] <Object[]>]
[-Depth <Int32>]
[-GroupBy <Object>]
[-View <String>]
[-ShowError]
[-DisplayError]
[-Force]
[-Expand <String>]
[-InputObject <PSObject>]
[<CommonParameters>]
Descrizione
Il Format-Custom
cmdlet formatta l'output di un comando come definito in una visualizzazione alternativa.
Format-Custom
è progettato per visualizzare le visualizzazioni che non sono solo tabelle o solo elenchi. È possibile usare le visualizzazioni definite nel formato *. File PS1XML nella directory di PowerShell oppure è possibile creare visualizzazioni personalizzate nei nuovi file PS1XML e usare il cmdlet Update-FormatData per aggiungerli a PowerShell.
Esempio
Esempio 1: Formattare l'output con una visualizzazione personalizzata
Get-Command Start-Transcript | Format-Custom -View MyView
Questo comando formatta informazioni sul Start-Transcript
cmdlet nel formato definito dalla visualizzazione MyView, una visualizzazione personalizzata creata dall'utente. Per eseguire correttamente questo comando, è prima necessario creare un nuovo file PS1XML, definire la visualizzazione MyView e quindi usare il comando per aggiungere il Update-FormatData
file PS1XML a PowerShell.
Esempio 2: Formattare l'output con la visualizzazione predefinita
Get-Process Winlogon | Format-Custom
Questo comando formatta le informazioni sul processo Winlogon in una visualizzazione personalizzata alternativa.
Poiché il comando non usa il parametro View , Format-Custom
usa una visualizzazione personalizzata predefinita per formattare i dati.
Esempio 3: Risoluzione degli errori di formato
Gli esempi seguenti mostrano i risultati dell'aggiunta dei parametri DisplayError o ShowError con un'espressione.
PC /> Get-Date | Format-Custom DayOfWeek,{ $_ / $null } -DisplayError
class DateTime
{
DayOfWeek = Friday
$_ / $null = #ERR
}
PC /> Get-Date | Format-Custom DayOfWeek,{ $_ / $null } -ShowError
class DateTime
{
DayOfWeek = Friday
$_ / $null =
}
Failed to evaluate expression " $_ / $null ".
+ CategoryInfo : InvalidArgument: (12/21/2018 8:01:04 AM:PSObject) [], RuntimeException
+ FullyQualifiedErrorId : PSPropertyExpressionError
Parametri
-Depth
Specifica il numero di colonne nella visualizzazione.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisplayError
Visualizza gli errori nella riga di comando. Questo parametro viene usato raramente, ma può essere usato come aiuto di debug quando si formattano espressioni in un Format-Custom
comando e le espressioni non sembrano funzionare.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Expand
Formatta l'oggetto raccolta, nonché gli oggetti nella raccolta. Questo parametro è progettato per formattare gli oggetti che supportano l'interfaccia ICollection (System.Collections). Il valore predefinito è EnumOnly.
I valori validi sono:
- EnumOnly: visualizza le proprietà degli oggetti nell'insieme.
- CoreOnly: visualizza le proprietà dell'oggetto raccolta.
- Entrambi: visualizza le proprietà dell'oggetto raccolta e le proprietà degli oggetti nell'insieme.
Type: | String |
Accepted values: | CoreOnly, EnumOnly, Both |
Position: | Named |
Default value: | EnumOnly |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Force
Indica al cmdlet di visualizzare tutte le informazioni sull'errore. Usare con i parametri DisplayError o ShowError . Per impostazione predefinita, quando un oggetto errore viene scritto nei flussi di errore o di visualizzazione, vengono visualizzate solo alcune informazioni sull'errore.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-GroupBy
Formatta l'output in gruppi in base a una proprietà o un valore condiviso. Immettere un'espressione o una proprietà dell'output.
Il valore del parametro GroupBy può essere una nuova proprietà calcolata. Per creare una proprietà calcolata, usare una tabella hash. Le chiavi valide sono:
- Nome (o etichetta) <stringa>
- Stringa> di espressione <o <blocco di script>
- Stringa FormatString <>
Type: | Object |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
Specifica gli oggetti da formattare. Immettere una variabile che contiene gli oggetti oppure digitare un comando o un'espressione che ottiene gli oggetti.
Type: | PSObject |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Property
Specifica le proprietà dell'oggetto che vengono presentate nella visualizzazione e l'ordine in cui appaiono. I caratteri jolly sono consentiti.
Se si omette questo parametro, le proprietà presentate nella visualizzazione dipendono dall'oggetto visualizzato. Il nome del parametro ("Property") è facoltativo. Non è possibile usare i parametri Proprietà e Visualizzazione nello stesso comando.
Il valore del parametro Property può essere una nuova proprietà calcolata. Per creare una proprietà calcolata, usare una tabella hash. Le chiavi valide sono:
- Stringa> di espressione <o <blocco di script>
- Profondità <int32>
Type: | Object[] |
Position: | 0 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-ShowError
Invia errori tramite la pipeline. Questo parametro viene usato raramente, ma può essere usato come aiuto di debug quando si formattano espressioni in un Format-Custom
comando e le espressioni non sembrano funzionare.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-View
Specifica il nome di un formato alternativo o "view". Se si omette questo parametro, Format-Custom
usa una visualizzazione personalizzata predefinita. Non è possibile usare i parametri Proprietà e Visualizzazione nello stesso comando.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Input
È possibile eseguire la pipe di qualsiasi oggetto in Format-Custom.
Output
Microsoft.PowerShell.Commands.Internal.Format
Format-Custom
restituisce gli oggetti di formato che rappresentano la visualizzazione.
Note
Format-Custom
è progettato per visualizzare le visualizzazioni che non sono solo tabelle o solo elenchi. Per visualizzare una visualizzazione tabella alternativa, usare Format-Table
. Per visualizzare una visualizzazione elenco alternativa, usare Format-List
.
È anche possibile fare riferimento all'alias Format-Custom
predefinito "fc". Per altre informazioni, vedere about_Aliases.
Il parametro GroupBy presuppone che gli oggetti siano ordinati. Prima di usare Format-Custom
per raggruppare gli oggetti, usare Sort-Object
per ordinarli.