Format-Hex

Référence

Module:: Microsoft.PowerShell.Utility

Affiche un fichier ou une autre entrée sous forme hexadécimale.

Syntax

Format-Hex
      [-Path] <string[]>
      [-Count <long>]
      [-Offset <long>]
      [<CommonParameters>]

Format-Hex
      -LiteralPath <string[]>
      [-Count <long>]
      [-Offset <long>]
      [<CommonParameters>]

Format-Hex
      -InputObject <psobject>
      [-Encoding <Encoding>]
      [-Count <long>]
      [-Offset <long>]
      [-Raw]
      [<CommonParameters>]

Description

L’applet Format-Hex de commande affiche un fichier ou une autre entrée sous forme de valeurs hexadécimales. Pour déterminer le décalage d’un caractère de la sortie, ajoutez le nombre le plus à gauche de la ligne au nombre situé en haut de la colonne pour ce caractère.

L’applet Format-Hex de commande peut vous aider à déterminer le type de fichier d’un fichier endommagé ou un fichier qui n’a peut-être pas d’extension de nom de fichier. Vous pouvez exécuter cette applet de commande, puis lire la sortie hexadécimale pour obtenir des informations sur le fichier.

Lorsque vous utilisez Format-Hex un fichier, l’applet de commande ignore les caractères de saut de ligne et retourne l’intégralité du contenu d’un fichier dans une chaîne avec les caractères de saut de ligne conservés.

Exemples

Exemple 1 : Obtenir la représentation hexadécimale d’une chaîne

Cette commande retourne les valeurs hexadécimales d’une chaîne.

'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 chaîne Hello World est envoyée vers le bas du pipeline à l’applet Format-Hex de commande. La sortie hexadécimale à partir d’affiche Format-Hex les valeurs de chaque caractère dans la chaîne.

Exemple 2 : Rechercher un type de fichier à partir d’une sortie hexadécimale

Cet exemple utilise la sortie hexadécimale pour déterminer le type de fichier. L’applet de commande affiche le chemin d’accès complet du fichier et les valeurs hexadécimales.

Pour tester la commande suivante, effectuez une copie d’un fichier PDF existant sur votre ordinateur local et renommez le fichier File.t7fcopié en .

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

L’applet Format-Hex de commande utilise le paramètre Path pour spécifier un nom de fichier dans le répertoire actif, File.t7f. L’extension de fichier .t7f est rare, mais la sortie hexadécimale %PDF indique qu’il s’agit d’un fichier PDF.

Paramètres

-Count

Cela représente le nombre d’octets à inclure dans la sortie hexadécimal.

Ce paramètre a été introduit dans PowerShell 6.2.

Type:	Int64
Position:	Named
Default value:	Int64.MaxValue
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Encoding

Spécifie l’encodage de la sortie. Cela s’applique uniquement à l’entrée [string] . Le paramètre n’a aucun effet sur les types numériques. La valeur par défaut est utf8NoBOM.

Les valeurs acceptables pour ce paramètre sont les suivantes :

ascii: utilise l’encodage pour le jeu de caractères ASCII (7 bits).
bigendianunicode: encode au format UTF-16 à l’aide de l’ordre d’octet big-endian.
oem: utilise l’encodage par défaut pour les programmes MS-DOS et console.
unicode: encode au format UTF-16 à l’aide de l’ordre d’octet little-endian.
utf7: encode au format UTF-7.
utf8: encode au format UTF-8.
utf8BOM: encode au format UTF-8 avec marque d’ordre d’octet (BOM)
utf8NoBOM: encode au format UTF-8 sans marque d’ordre d’octet (BOM)
utf32: encode au format UTF-32.

À compter de PowerShell 6.2, le paramètre d’encodage autorise également les ID numériques des pages de codes inscrites (par exemple -Encoding 1251) ou des noms de chaînes de pages de codes inscrites (par exemple -Encoding "windows-1251"). Pour plus d’informations, consultez la documentation .NET pour Encoding.CodePage.

Type:	Encoding
Accepted values:	ASCII, BigEndianUnicode, OEM, Unicode, UTF7, UTF8, UTF8BOM, UTF8NoBOM, UTF32
Position:	Named
Default value:	UTF8NoBOM
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

Utilisé pour l’entrée de pipeline. L’entrée de pipeline prend uniquement en charge certains types et [system.io.fileinfo] instances scalaires à partir de Get-ChildItem.

Les types scalaires pris en charge sont les suivants :

[string], [char]
[byte], [sbyte]
[int16], [uint16], [short], [ushort]
[int], [uint], [int32], [uint32],
[long], [ulong], [int64], [uint64]
[single], [float], [double]

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

-LiteralPath

Spécifie le chemin d’accès complet à un fichier. La valeur de LiteralPath est utilisée exactement comme elle est typée. Ce paramètre n’accepte pas les caractères génériques. Pour spécifier plusieurs chemins d’accès aux fichiers, séparez les chemins d’accès par une virgule. Si le paramètre LiteralPath inclut des caractères d’échappement, placez le chemin entre guillemets simples. PowerShell n’interprète aucun caractère dans une seule chaîne entre guillemets comme séquences d’échappement. Pour plus d’informations, consultez about_Quoting_Rules.

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

-Offset

Cela représente le nombre d’octets à ignorer pour faire partie de la sortie hexadécimal.

Ce paramètre a été introduit dans PowerShell 6.2.

Type:	Int64
Position:	Named
Default value:	0
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Path

Spécifie le chemin d’accès aux fichiers. Utilisez un point (.) pour spécifier l’emplacement actuel. Le caractère générique (*) est accepté et peut être utilisé pour spécifier tous les éléments d’un emplacement. Si le paramètre Path inclut des caractères d’échappement, placez le chemin entre guillemets simples. Pour spécifier plusieurs chemins d’accès aux fichiers, séparez les chemins d’accès par une virgule.

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

-Raw

Ce paramètre ne fait plus rien. Elle est conservée pour la compatibilité des scripts.

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

Entrées

String

Vous pouvez diriger une chaîne vers cette applet de commande.

Sorties

ByteCollection

Cette applet de commande retourne un ByteCollection. Cet objet représente une collection d’octets. Il inclut des méthodes qui convertissent la collection d’octets en une chaîne mise en forme comme chaque ligne de sortie retournée par Format-Hex. Si vous spécifiez le paramètre Path ou LiteralPath , l’objet contient également le chemin du fichier qui contient chaque octet.

Notes

La colonne la plus à droite de la sortie tente de restituer les octets sous forme de caractères ASCII :

En règle générale, chaque octet est interprété comme un point de code Unicode, ce qui signifie que :

Les caractères ASCII imprimables sont toujours affichés correctement
Les caractères UTF-8 multioctets ne s’affichent jamais correctement
Les caractères UTF-16 s’affichent correctement uniquement si leur octet de haut ordre se produit NUL.