Format-Hex

Модуль:: Microsoft.PowerShell.Utility Module

Отображает файл или другие входные данные как шестнадцатеричные.

Синтаксис

Path

Format-Hex
    [-Path] <String[]>
    [-Count <Int64>]
    [-Offset <Int64>]
    [<CommonParameters>]

LiteralPath

Format-Hex
    -LiteralPath <String[]>
    [-Count <Int64>]
    [-Offset <Int64>]
    [<CommonParameters>]

ByInputObject

Format-Hex
    -InputObject <PSObject>
    [-Encoding <Encoding>]
    [-Count <Int64>]
    [-Offset <Int64>]
    [-Raw]
    [<CommonParameters>]

Описание

Командлет Format-Hex отображает файл или другие входные данные в виде шестнадцатеричных значений. Чтобы определить смещение символа из выходных данных, добавьте число в самую левую часть строки в число в верхней части столбца для этого знака.

Командлет Format-Hex поможет определить тип файла поврежденного файла или файла, который может не иметь расширения имени файла. Этот командлет можно запустить, а затем прочитать шестнадцатеричные выходные данные, чтобы получить сведения о файле.

При использовании Format-Hex в файле командлет игнорирует символы новой строки и возвращает все содержимое файла в одной строке с сохраненными символами новой строки.

Примеры

Пример 1. Получение шестнадцатеричного представления строки

Эта команда возвращает шестнадцатеричные значения строки.

'Hello World' | Format-Hex

   Label: String (System.String) <2944BEC3>

          Offset Bytes                                           Ascii
                 00 01 02 03 04 05 06 07 08 09 0A 0B 0C 0D 0E 0F
          ------ ----------------------------------------------- -----
0000000000000000 48 65 6C 6C 6F 20 57 6F 72 6C 64                Hello World

Строка Hello World отправляется по конвейеру командлету Format-Hex. Шестнадцатеричные выходные данные из Format-Hex отображают значения каждого символа в строке.

Пример 2. Поиск типа файла из шестнадцатеричных выходных данных

В этом примере шестнадцатеричные выходные данные используются для определения типа файла. Командлет отображает полный путь к файлу и шестнадцатеричные значения.

Чтобы проверить следующую команду, создайте копию существующего PDF-файла на локальном компьютере и переименуйте скопированный файл в File.t7f.

Format-Hex -Path .\File.t7f -Count 48

   Label: C:\Test\File.t7f

          Offset Bytes                                           Ascii
                 00 01 02 03 04 05 06 07 08 09 0A 0B 0C 0D 0E 0F
          ------ ----------------------------------------------- -----
0000000000000000 25 50 44 46 2D 31 2E 35 0D 0A 25 B5 B5 B5 B5 0D %PDF-1.5..%????.
0000000000000010 0A 31 20 30 20 6F 62 6A 0D 0A 3C 3C 2F 54 79 70 .1 0 obj..<</Typ
0000000000000020 65 2F 43 61 74 61 6C 6F 67 2F 50 61 67 65 73 20 e/Catalog/Pages

Командлет Format-Hex использует параметр пути для указания имени файла в текущем каталоге File.t7f. Расширение файла .t7f редко, но шестнадцатеричные выходные данные %PDF показывают, что это PDF-файл. В этом примере параметр Count используется для ограничения выходных данных до первых 48 байт файла.

Пример 3. Форматирование массива различных типов данных

В этом примере используется массив различных типов данных, чтобы подчеркнуть, как Format-Hex обрабатывает их в конвейере.

Он передает каждый объект через конвейер и обрабатывается по отдельности. Однако, если это числовые данные, а смежный объект также числовый, он будет сгруппировать их в один выходной блок.

'Hello world!', 1, 1138, 'foo', 'bar', 0xdeadbeef, 1gb, 0b1101011100 , $true, $false |
    Format-Hex

   Label: String (System.String) <24F1F0A3>

          Offset Bytes                                           Ascii
                 00 01 02 03 04 05 06 07 08 09 0A 0B 0C 0D 0E 0F
          ------ ----------------------------------------------- -----
0000000000000000 48 65 6C 6C 6F 20 77 6F 72 6C 64 21             Hello world!

   Label: Int32 (System.Int32) <2EB933C5>

          Offset Bytes                                           Ascii
                 00 01 02 03 04 05 06 07 08 09 0A 0B 0C 0D 0E 0F
          ------ ----------------------------------------------- -----
0000000000000000 01 00 00 00 72 04 00 00                         �   r�

   Label: String (System.String) <4078B66C>

          Offset Bytes                                           Ascii
                 00 01 02 03 04 05 06 07 08 09 0A 0B 0C 0D 0E 0F
          ------ ----------------------------------------------- -----
0000000000000000 66 6F 6F                                        foo

   Label: String (System.String) <51E4A317>

          Offset Bytes                                           Ascii
                 00 01 02 03 04 05 06 07 08 09 0A 0B 0C 0D 0E 0F
          ------ ----------------------------------------------- -----
0000000000000000 62 61 72                                        bar

   Label: Int32 (System.Int32) <5ADF167B>

          Offset Bytes                                           Ascii
                 00 01 02 03 04 05 06 07 08 09 0A 0B 0C 0D 0E 0F
          ------ ----------------------------------------------- -----
0000000000000000 EF BE AD DE 00 00 00 40 5C 03 00 00             ï¾-Þ   @\�

   Label: Boolean (System.Boolean) <7D8C4C1D>

          Offset Bytes                                           Ascii
                 00 01 02 03 04 05 06 07 08 09 0A 0B 0C 0D 0E 0F
          ------ ----------------------------------------------- -----
0000000000000000 01 00 00 00 00 00 00 00                         �

Параметры

-Count

Это число байтов, включаемых в шестнадцатеричные выходные данные.

Этот параметр появился в PowerShell 6.2.

Свойства параметра

Тип:	Int64
Default value:	Int64.MaxValue
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-Encoding

Задает кодировку входных строк. Это относится только к [string] входным данным. Параметр не влияет на числовые типы. Выходное значение всегда utf8NoBOM.

Допустимые значения для этого параметра приведены следующим образом:

ascii: использует кодировку для набора символов ASCII (7-разрядный).
ansi. Использует кодировку текущей культуры для кодовой страницы ANSI. Этот параметр добавлен в PowerShell 7.4.
bigendianunicode: кодирует в формате UTF-16 с использованием большого порядка байтов.
bigendianutf32: кодирует в формате UTF-32 в порядке старших байтов.
oem. Использует кодировку по умолчанию для MS-DOS и консольных программ.
unicode: кодирует в формате UTF-16 в порядке байтов младшего разряда.
utf7: кодирует в формате UTF-7.
utf8: кодирует в формате UTF-8.
utf8BOM. Кодирует в формате UTF-8 с пометкой порядка байтов (Byte Order Mark, BOM)
utf8NoBOM: Кодирует в формате UTF-8 без метки порядка байтов (BOM)
utf32: кодирует в формате UTF-32.

Начиная с PowerShell 6.2, параметр кодировки также позволяет использовать числовые идентификаторы зарегистрированных кодовых страниц (например, ) или строковые имена зарегистрированных кодовых страниц (например, ). Дополнительные сведения см. в документации .NET для Encoding.CodePage.

Начиная с PowerShell 7.4, можно использовать значение Ansi для параметра кодировки, чтобы передать числовой идентификатор ANSI-страницы текущей культуры, не указывая его вручную.

Замечание

UTF-7* больше не рекомендуется использовать. Начиная с версии PowerShell 7.1, выводится предупреждение, если задать utf7 как параметр кодировки.

Свойства параметра

Тип:	Encoding
Default value:	UTF8NoBOM
Допустимые значения:	ASCII, BigEndianUnicode, BigEndianUTF32, OEM, Unicode, UTF7, UTF8, UTF8BOM, UTF8NoBOM, UTF32
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

ByInputObject

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-InputObject

Указывает объекты, которые нужно отформатировать. Введите переменную, содержащую объекты или введите команду или выражение, которое получает объекты.

Поддерживаются только некоторые скалярные типа и [System.IO.FileInfo].

Поддерживаемые скалярные типы:

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

До PowerShell 6.2 Format-Hex будет обрабатывать входные данные конвейера с несколькими типами входных данных, группируя все такие объекты вместе. Теперь он обрабатывает каждый отдельный объект по мере прохождения конвейера и не группирует объекты вместе, если только объекты не находятся рядом.

Свойства параметра

Тип:	PSObject
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

ByInputObject

Position:	Named
Обязательно:	True
Значение из конвейера:	True
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-LiteralPath

Указывает полный путь к файлу. Значение LiteralPath используется именно так, как оно введено. Этот параметр не принимает подстановочные знаки. Чтобы указать несколько путей к файлам, разделите пути с запятой. Если параметр LiteralPath включает escape-символы, заключите путь в одинарные кавычки. PowerShell не интерпретирует никакие символы в одной кавычки как escape-последовательности. Дополнительную информацию см. в разделе about_Quoting_Rules.

Свойства параметра

Тип:	String[]
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False
Aliases:	PSPath, LP

Наборы параметров

LiteralPath

Position:	Named
Обязательно:	True
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-Offset

Это число байтов для пропуска от части шестнадцатеричного вывода.

Этот параметр появился в PowerShell 6.2.

Свойства параметра

Тип:	Int64
Default value:	0
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-Path

Указывает путь к файлам. Используйте точку (.), чтобы указать текущее расположение. Подстановочный знак (*) принимается и может использоваться для указания всех элементов в расположении. Если параметр Path включает escape-символы, заключите путь в одинарные кавычки. Чтобы указать несколько путей к файлам, разделите пути с запятой.

Свойства параметра

Тип:	String[]
Default value:	None
Поддерживаются подстановочные знаки:	True
DontShow:	False

Наборы параметров

Path

Position:	0
Обязательно:	True
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-Raw

Этот параметр больше не делает ничего. Он сохраняется для совместимости скриптов.

Свойства параметра

Тип:	SwitchParameter
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

ByInputObject

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.

Входные данные

String

Вы можете передать строку в этот командлет.

Выходные данные

ByteCollection

Этот командлет возвращает ByteCollection. Этот объект представляет коллекцию байтов. Он включает методы, которые преобразуют коллекцию байтов в строку, отформатированную как каждая строка выходных данных, возвращаемая Format-Hex. Выходные данные также отображают тип обрабатываемых байтов. Если указать параметр path или LiteralPath, объект содержит путь к файлу, который содержит каждый байт. Если вы передаете строку, логическое значение, целое число и т. д., она будет помечена соответствующим образом.

Примечания

PowerShell включает следующие псевдонимы для Format-Hex:

Все платформы:
- fhx

Правый столбец выходных данных пытается отобразить байты в виде символов ASCII:

Как правило, каждый байт интерпретируется как кодовая точка Юникода, что означает следующее:

Отображаемые символы ASCII всегда отображаются правильно
Многобайтовые символы UTF-8 никогда не отображаются правильно
Символы UTF-16 отрисовываются правильно, только если их байты высокого порядка выполняются NUL.

Обратная связь

Была ли эта страница полезна?

Поделиться через

Format-Hex

Синтаксис

Path

LiteralPath

ByInputObject

Описание

Примеры

Пример 1. Получение шестнадцатеричного представления строки

Пример 2. Поиск типа файла из шестнадцатеричных выходных данных

Пример 3. Форматирование массива различных типов данных

Параметры

-Count

Свойства параметра

Наборы параметров

-Encoding

Свойства параметра

Наборы параметров

-InputObject

Свойства параметра

Наборы параметров

-LiteralPath

Свойства параметра

Наборы параметров

-Offset

Свойства параметра

Наборы параметров

-Path

Свойства параметра

Наборы параметров

-Raw

Свойства параметра

Наборы параметров

CommonParameters

Входные данные

String

Выходные данные

ByteCollection

Примечания

Связанные ссылки

Обратная связь