Condividi tramite

Format-Hex

  • Riferimento
Modulo:
Microsoft.PowerShell.Utility

Visualizza un file o un altro input come esadecimale.

Sintassi

Format-Hex
      [-Path] <string[]>
      [<CommonParameters>]
Format-Hex
      -LiteralPath <string[]>
      [<CommonParameters>]
Format-Hex
      -InputObject <Object>
      [-Encoding <string>]
      [-Raw]
      [<CommonParameters>]

Descrizione

Il Format-Hex cmdlet visualizza un file o un altro input come valori esadecimali. Per determinare l'offset di un carattere dall'output, aggiungere il numero all'estrema sinistra della riga al numero nella parte superiore della colonna per tale carattere.

Il Format-Hex cmdlet consente di determinare il tipo di file di un file danneggiato o un file che potrebbe non avere un'estensione del nome file. È possibile eseguire questo cmdlet e quindi leggere l'output esadecimale per ottenere informazioni sul file.

Quando si usa Format-Hex in un file, il cmdlet ignora i caratteri di nuova riga e restituisce l'intero contenuto di un file in una stringa con i caratteri di nuova riga mantenuti.

Esempio

Esempio 1: Ottenere la rappresentazione esadecimale di una stringa

Questo comando restituisce i valori esadecimali di una stringa.

'Hello World' | Format-Hex

00 01 02 03 04 05 06 07 08 09 0A 0B 0C 0D 0E 0F

00000000   48 65 6C 6C 6F 20 57 6F 72 6C 64                 Hello World

La stringa Hello World viene inviata alla pipeline al Format-Hex cmdlet . L'output esadecimale da Format-Hex mostra i valori di ogni carattere nella stringa.

Esempio 2: Trovare un tipo di file dall'output esadecimale

In questo esempio viene usato l'output esadecimale per determinare il tipo di file. Il cmdlet visualizza il percorso completo del file e i valori esadecimali.

Per testare il comando seguente, creare una copia di un file PDF esistente nel computer locale e rinominare il file copiato in File.t7f.

Format-Hex -Path .\File.t7f

Path: C:\Test\File.t7f

           00 01 02 03 04 05 06 07 08 09 0A 0B 0C 0D 0E 0F

00000000   25 50 44 46 2D 31 2E 35 0D 0A 25 B5 B5 B5 B5 0D  %PDF-1.5..%????.
00000010   0A 31 20 30 20 6F 62 6A 0D 0A 3C 3C 2F 54 79 70  .1 0 obj..<</Typ
00000020   65 2F 43 61 74 61 6C 6F 67 2F 50 61 67 65 73 20  e/Catalog/Pages

Il Format-Hex cmdlet usa il parametro Path per specificare un nome file nella directory corrente, File.t7f. L'estensione .t7f del file non è comune, ma l'output %PDF esadecimale mostra che si tratta di un file PDF.

Esempio 3: Visualizzare l'output esadecimale non elaborato

Per impostazione predefinita Format-Hex , opta per l'output compatto dei tipi di dati numerici: le sequenze a byte singolo o doppio byte vengono usate se il valore è sufficientemente piccolo. Il parametro Raw disattiva questo comportamento.

PS> 1,2,3,1000 | Format-Hex

           Path:

           00 01 02 03 04 05 06 07 08 09 0A 0B 0C 0D 0E 0F

00000000   01 02 03 E8 03                                   ...è.


PS> 1,2,3,1000 | Format-Hex -Raw

           Path:

           00 01 02 03 04 05 06 07 08 09 0A 0B 0C 0D 0E 0F

00000000   01 00 00 00 02 00 00 00 03 00 00 00 E8 03 00 00  ............è...

Si noti la differenza nell'output. Il parametro Raw visualizza i numeri come valori a 4 byte, true per i relativi tipi Int32 .

Parametri

-Encoding

Specifica la codifica dell'output. Questo vale solo per l'input [string] . Il parametro non ha alcun effetto sui tipi numerici. Il valore predefinito è ASCII.

I valori accettabili per questo parametro sono i seguenti:

  • Ascii Usa il set di caratteri ASCII (a 7 bit).
  • BigEndianUnicode Usa UTF-16 con l'ordine dei byte big-endian.
  • Unicode Usa UTF-16 con l'ordine dei byte little-endian.
  • UTF7 Usa UTF-7.
  • UTF8 Usa UTF-8.
  • UTF32 Usa UTF-32 con l'ordine dei byte little-endian.

I caratteri non ASCII nell'input vengono restituiti come caratteri letterali ? con conseguente perdita di informazioni.

Type:String
Accepted values:ASCII, BigEndianUnicode, Unicode, UTF7, UTF8, UTF32
Position:Named
Default value:ASCII
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.

Sono supportati solo determinati tipi scalari e [system.io.fileinfo] .

I tipi scalari supportati sono:

  • [string]
  • [byte]
  • [int], [int32]
  • [long], [int64]
Type:Object
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-LiteralPath

Specifica il percorso completo di un file. Il valore di LiteralPath viene usato esattamente come viene tipizzato. Questo parametro non accetta caratteri jolly. Per specificare più percorsi per i file, separare i percorsi con una virgola. Se il parametro LiteralPath include caratteri di escape, racchiudere il percorso tra virgolette singole. PowerShell non interpreta i caratteri in una singola stringa tra virgolette come sequenze di escape. Per altre informazioni, vedere about_Quoting_Rules.

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

-Path

Specifica il percorso dei file. Usare un punto (.) per specificare la posizione corrente. Il carattere jolly (*) viene accettato e può essere usato per specificare tutti gli elementi in una posizione. Se il parametro Path include caratteri di escape, racchiudere il percorso tra virgolette singole. Per specificare più percorsi per i file, separare i percorsi con una virgola.

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

-Raw

Per impostazione predefinita Format-Hex , opta per l'output compatto dei tipi di dati numerici: le sequenze a byte singolo o doppio byte vengono usate se il valore è sufficientemente piccolo. Il parametro Raw disattiva questo comportamento.

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

Input

String

È possibile inviare tramite pipe una stringa a questo cmdlet.

Output

ByteCollection

Questo cmdlet restituisce un Oggetto ByteCollection. Questo oggetto rappresenta una raccolta di byte. Include metodi che convertono la raccolta di byte in una stringa formattata come ogni riga di output restituita da Format-Hex. Se si specifica il parametro Path o LiteralPath , l'oggetto contiene anche il percorso del file che contiene ogni byte.

Note

Windows PowerShell include gli alias seguenti per Format-Hex:

  • fhx

La colonna di output più a destra tenta di eseguire il rendering dei byte come caratteri:

In genere, ogni byte viene interpretato come punto di codice Unicode, il che significa che:

  • Il rendering dei caratteri ASCII stampabili viene sempre eseguito correttamente
  • Il rendering dei caratteri UTF-8 a più byte non viene mai eseguito correttamente
  • I caratteri UTF-16 vengono visualizzati correttamente solo se il byte di ordine elevato è NUL.