Delen via

Format-Hex

  • Referentie
Module:
Microsoft.PowerShell.Utility

Geeft een bestand of andere invoer weer als hexadecimaal.

Syntaxis

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

Description

De Format-Hex-cmdlet geeft een bestand of andere invoer weer als hexadecimale waarden. Als u de verschuiving van een teken uit de uitvoer wilt bepalen, voegt u het getal aan de linkerkant van de rij toe aan het getal boven aan de kolom voor dat teken.

De Format-Hex cmdlet kan u helpen bij het bepalen van het bestandstype van een beschadigd bestand of een bestand dat mogelijk geen bestandsnaamextensie heeft. U kunt deze cmdlet uitvoeren en vervolgens de hexadecimale uitvoer lezen om bestandsgegevens op te halen.

Wanneer u Format-Hex op een bestand gebruikt, worden nieuwelinetekens genegeerd en wordt de volledige inhoud van een bestand in één tekenreeks geretourneerd, waarbij de nieuwe regeltekens behouden blijven.

Voorbeelden

Voorbeeld 1: de hexadecimale weergave van een tekenreeks ophalen

Met deze opdracht worden de hexadecimale waarden van een tekenreeks geretourneerd.

'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

De tekenreeks Hello World- wordt naar de Format-Hex-cmdlet verzonden. De hexadecimale uitvoer van Format-Hex toont de waarden van elk teken in de tekenreeks.

Voorbeeld 2: Een bestandstype zoeken uit de hexadecimale uitvoer

In dit voorbeeld wordt de hexadecimale uitvoer gebruikt om het bestandstype te bepalen. De cmdlet geeft het volledige pad van het bestand en de hexadecimale waarden weer.

Als u de volgende opdracht wilt testen, maakt u een kopie van een bestaand PDF-bestand op uw lokale computer en wijzigt u de naam van het gekopieerde bestand 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

De cmdlet Format-Hex gebruikt de parameter Path om een bestandsnaam op te geven in de huidige map, File.t7f. De bestandsextensie .t7f is ongebruikelijk, maar de hexadecimale uitvoer %PDF laat zien dat het een PDF-bestand is.

Voorbeeld 3: Onbewerkte hexadecimale uitvoer weergeven

Standaard Format-Hex kiest voor compacte uitvoer van numerieke gegevenstypen: reeksen met één byte of dubbel-byte worden gebruikt als de waarde klein genoeg is. Met de parameter Raw wordt dit gedrag gedeactiveerd.

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  ............è...

Let op het verschil in uitvoer. De parameter Raw geeft de getallen weer als vier bytewaarden, waar voor de Int32 typen.

Parameters

-Encoding

Hiermee geeft u de codering van de uitvoer. Dit geldt alleen voor [string] invoer. De parameter heeft geen effect op numerieke typen. De standaardwaarde is ASCII.

De acceptabele waarden voor deze parameter zijn als volgt:

  • Ascii maakt gebruik van ASCII-tekenset (7-bits).
  • BigEndianUnicode gebruikt UTF-16 met de bytevolgorde big-endian.
  • Unicode gebruikt UTF-16 met de bytevolgorde little-endian.
  • UTF7 maakt gebruik van UTF-7.
  • UTF8 maakt gebruik van UTF-8.
  • UTF32 gebruikt UTF-32 met de bytevolgorde little-endian.

Niet-ASCII-tekens in de invoer zijn uitvoer als letterlijke ? tekens die leiden tot verlies van informatie.

Type:String
Geaccepteerde waarden:ASCII, BigEndianUnicode, Unicode, UTF7, UTF8, UTF32
Position:Named
Default value:ASCII
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-InputObject

Hiermee geeft u de objecten die moeten worden opgemaakt. Voer een variabele in die de objecten bevat of typ een opdracht of expressie waarmee de objecten worden opgehaald.

Alleen bepaalde scalaire typen en [system.io.fileinfo] worden ondersteund.

De ondersteunde scalaire typen zijn:

  • [string]
  • [byte]
  • [int], [int32]
  • [long], [int64]
Type:Object
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-LiteralPath

Hiermee geeft u het volledige pad naar een bestand. De waarde van LiteralPath- wordt exact gebruikt zoals deze is getypt. Deze parameter accepteert geen jokertekens. Als u meerdere paden naar bestanden wilt opgeven, scheidt u de paden met een komma. Als de parameter LiteralPath escape-tekens bevat, plaatst u het pad tussen enkele aanhalingstekens. PowerShell interpreteert geen tekens in één tekenreeks tussen aanhalingstekens als escapereeksen. Zie about_Quoting_Rulesvoor meer informatie.

Type:String[]
Aliassen:PSPath
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Path

Hiermee geeft u het pad naar bestanden. Gebruik een punt (.) om de huidige locatie op te geven. Het jokerteken (*) wordt geaccepteerd en kan worden gebruikt om alle items op een locatie op te geven. Als de parameter Pad escapetekens bevat, plaatst u het pad tussen enkele aanhalingstekens. Als u meerdere paden naar bestanden wilt opgeven, scheidt u de paden met een komma.

Type:String[]
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:True

-Raw

Standaard Format-Hex kiest voor compacte uitvoer van numerieke gegevenstypen: reeksen met één byte of dubbel-byte worden gebruikt als de waarde klein genoeg is. Met de parameter Raw wordt dit gedrag gedeactiveerd.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

String

U kunt een tekenreeks doorsluisen naar deze cmdlet.

Uitvoerwaarden

ByteCollection

Met deze cmdlet wordt een ByteCollection-geretourneerd. Dit object vertegenwoordigt een verzameling bytes. Het bevat methoden waarmee de verzameling bytes wordt geconverteerd naar een tekenreeks die is opgemaakt zoals elke regel uitvoer die wordt geretourneerd door Format-Hex. Als u de parameter Path of LiteralPath opgeeft, bevat het object ook het pad van het bestand dat elke byte bevat.

Notities

Windows PowerShell bevat de volgende aliassen voor Format-Hex:

  • fhx

De meest rechtse kolom met uitvoer probeert de bytes als tekens weer te geven:

Over het algemeen wordt elke byte geïnterpreteerd als een Unicode-codepunt, wat betekent dat:

  • Afdrukbare ASCII-tekens worden altijd correct weergegeven
  • UTF-8 tekens met meerdere bytes worden nooit correct weergegeven
  • UTF-16 tekens worden alleen correct weergegeven als hun byte in hoge volgorde plaatsvindt NUL.