Compartilhar via

Format-Hex

Módulo:
Microsoft.PowerShell.Utility Module

Exibe um arquivo ou outra entrada como hexadecimal.

Sintaxe

Path (Default) 

Format-Hex
    [-Path] <string[]>
    [<CommonParameters>]

LiteralPath 

Format-Hex
    -LiteralPath <string[]>
    [<CommonParameters>]

ByInputObject 

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

Description

O cmdlet Format-Hex exibe um arquivo ou outra entrada como valores hexadecimal. Para determinar o deslocamento de um caractere da saída, adicione o número à esquerda da linha ao número na parte superior da coluna para esse caractere.

O cmdlet Format-Hex pode ajudá-lo a determinar o tipo de arquivo de um arquivo corrompido ou um arquivo que pode não ter uma extensão de nome de arquivo. Você pode executar esse cmdlet e ler a saída hexadecimal para obter informações do arquivo.

Ao usar Format-Hex em um arquivo, o cmdlet ignora caracteres de nova linha e retorna todo o conteúdo de um arquivo em uma cadeia de caracteres com os caracteres de nova linha preservados.

Exemplos

Exemplo 1: Obter a representação hexadecimal de uma cadeia de caracteres

Esse comando retorna os valores hexadecimal de uma cadeia de caracteres.

'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

A cadeia de caracteres Hello World é enviada pelo pipeline para o cmdlet Format-Hex. A saída hexadecimal de Format-Hex mostra os valores de cada caractere na cadeia de caracteres.

Exemplo 2: localizar um tipo de arquivo da saída hexadecimal

Este exemplo usa a saída hexadecimal para determinar o tipo de arquivo. O cmdlet exibe o caminho completo do arquivo e os valores hexadecimal.

Para testar o comando a seguir, faça uma cópia de um arquivo PDF existente no computador local e renomeie o arquivo copiado para 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

O cmdlet Format-Hex usa o parâmetro Path para especificar um nome de arquivo no diretório atual, File.t7f. A extensão de arquivo .t7f é incomum, mas a saída hexadecimal %PDF mostra que é um arquivo PDF.

Exemplo 3: Exibir saída hexadecimal bruta

Por padrão, Format-Hex opta pela saída compacta de tipos de dados numéricos: sequências de bytes únicos ou de bytes duplos são usadas se o valor for pequeno o suficiente. O parâmetro Raw desativa esse 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  ............è...

Observe a diferença na saída. O parâmetro Raw exibe os números como valores de 4 bytes, verdadeiros para seus tipos de Int32.

Parâmetros

-Encoding

Especifica a codificação da saída. Isso só se aplica a [string] entrada. O parâmetro não tem efeito sobre tipos numéricos. O valor padrão é ASCII.

Os valores aceitáveis para esse parâmetro são os seguintes:

  • Ascii usa conjunto de caracteres ASCII (7 bits).
  • BigEndianUnicode usa UTF-16 com a ordem de bytes big-endian.
  • Unicode usa UTF-16 com a ordem de bytes little-endian.
  • UTF7 usa UTF-7.
  • UTF8 usa UTF-8.
  • UTF32 usa UTF-32 com a ordem de bytes little-endian.

Caracteres não ASCII na entrada são saída como caracteres de ? literais, resultando em uma perda de informações.

Propriedades do parâmetro

Tipo:String
Valor padrão:ASCII
Valores aceitos:ASCII, BigEndianUnicode, Unicode, UTF7, UTF8, UTF32
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

ByInputObject
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-InputObject

Especifica os objetos a serem formatados. Insira uma variável que contenha os objetos ou digite um comando ou expressão que obtém os objetos.

Há suporte apenas para determinados tipos de escalares e [System.IO.FileInfo].

Os tipos escalares com suporte são:

  • [string]
  • [byte]
  • [int], [int32]
  • [long], [int64]

Propriedades do parâmetro

Tipo:Object
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

ByInputObject
Cargo:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-LiteralPath

Especifica o caminho completo para um arquivo. O valor de LiteralPath é usado exatamente como é digitado. Esse parâmetro não aceita caracteres curinga. Para especificar vários caminhos para arquivos, separe os caminhos com uma vírgula. Se o parâmetro LiteralPath incluir caracteres de escape, coloque o caminho entre aspas simples. O PowerShell não interpreta nenhum caractere em uma única cadeia de caracteres entre aspas como sequências de escape. Para mais informações, consulte sobre_Regras_de_Citação.

Propriedades do parâmetro

Tipo:

String[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:PSPath

Conjuntos de parâmetros

LiteralPath
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Path

Especifica o caminho para arquivos. Use um ponto (.) para especificar o local atual. O caractere curinga (*) é aceito e pode ser usado para especificar todos os itens em um local. Se o parâmetro Path incluir caracteres de escape, coloque o caminho entre aspas simples. Para especificar vários caminhos para arquivos, separe os caminhos com uma vírgula.

Propriedades do parâmetro

Tipo:

String[]

Valor padrão:None
Dá suporte a curingas:True
DontShow:False

Conjuntos de parâmetros

Path
Cargo:0
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Raw

Por padrão, Format-Hex opta pela saída compacta de tipos de dados numéricos: sequências de bytes únicos ou de bytes duplos são usadas se o valor for pequeno o suficiente. O parâmetro Raw desativa esse comportamento.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

ByInputObject
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Entradas

String

Você pode encaminhar uma cadeia de caracteres para este cmdlet.

Saídas

ByteCollection

Esse cmdlet retorna um byteCollection. Esse objeto representa uma coleção de bytes. Ele inclui métodos que convertem a coleção de bytes em uma cadeia de caracteres formatada como cada linha de saída retornada por Format-Hex. Se você especificar o de Caminho ou parâmetro LiteralPath, o objeto também conterá o caminho do arquivo que contém cada byte.

Observações

O Windows PowerShell inclui os seguintes aliases para Format-Hex:

  • fhx

A coluna mais à direita da saída tenta renderizar os bytes como caracteres:

Em geral, cada byte é interpretado como um ponto de código Unicode, o que significa que:

  • Caracteres ASCII imprimíveis são sempre renderizados corretamente
  • Caracteres UTF-8 de vários bytes nunca são renderizados corretamente
  • Os caracteres UTF-16 serão renderizados corretamente somente se o byte de alta ordem ocorrer NUL.