Format-Hex

リファレンス

モジュール:: Microsoft.PowerShell.Utility

ファイルまたはその他の入力を 16 進数で表示します。

構文

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

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

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

説明

コマンドレットは Format-Hex 、ファイルまたはその他の入力を 16 進数の値として表示します。出力からの文字のオフセットを決定するには、行の左端にある数値を、その文字の列の先頭にある数値に追加します。

このコマンドレットは Format-Hex 、破損したファイルの種類、またはファイル名拡張子がない可能性のあるファイルを特定するのに役立ちます。このコマンドレットを実行し、16 進数の出力を読み取ってファイル情報を取得できます。

ファイルで使用 Format-Hex する場合、コマンドレットは改行文字を無視し、改行文字が保持されたファイルの内容全体を 1 つの文字列で返します。

例

例 1: 文字列の 16 進数表現を取得する

このコマンドは、文字列の 16 進値を返します。

'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 送信されます。 16 進数の出力は Format-Hex 、文字列内の各文字の値を示しています。

例 2: 16 進数の出力からファイルの種類を検索する

この例では、16 進数の出力を使用してファイルの種類を決定します。コマンドレットは、ファイルの完全なパスと 16 進数の値を表示します。

次のコマンドをテストするには、ローカルコンピューター上の既存の 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、Path パラメーターを使用して、File.t7f現在のディレクトリのファイル名を指定します。ファイル拡張子 .t7f は一般的ではありませんが、16 進数の出力 %PDF は PDF ファイルであることを示しています。この例では、Count パラメーターを使用して、出力をファイルの最初の 48 バイトに制限します。

例 3: さまざまなデータ型の配列を書式設定する

この例では、さまざまなデータ型の配列を使用して、パイプラインでの処理方法を強調表示 Format-Hex します。

各オブジェクトがパイプラインを通過し、個別に処理されます。ただし、数値データであり、隣接するオブジェクトも数値である場合は、それらを 1 つの出力ブロックにグループ化します。

'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

これは、16 進出力に含めるバイト数を表します。

このパラメーターは、PowerShell 6.2 で導入されました。

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

-Encoding

入力文字列のエンコードを指定します。これは入力にのみ適用されます [string] 。このパラメーターは数値型には影響しません。出力値は常に utf8NoBOM.

このパラメーターに使用できる値は次のとおりです。

ascii: ASCII (7 ビット) 文字セットのエンコードを使用します。
bigendianunicode: ビッグエンディアンバイト順を使用して UTF-16 形式でエンコードします。
bigendianutf32: ビッグエンディアンバイト順を使用して UTF-32 形式でエンコードします。
oem: MS-DOS およびコンソールプログラムの既定のエンコードを使用します。
unicode: リトルエンディアンバイト順を使用して UTF-16 形式でエンコードします。
utf7: UTF-7 形式でエンコードします。
utf8: UTF-8 形式でエンコードします。
utf8BOM: バイトオーダーマーク (BOM) を使用して UTF-8 形式でエンコードします。
utf8NoBOM: バイトオーダーマーク (BOM) を使用せずに UTF-8 形式でエンコードします。
utf32: UTF-32 形式でエンコードします。

PowerShell 6.2 以降では、Encoding パラメーターを使用すると、登録済みコードページの数値 ID (いいね) -Encoding 1251や登録済みコードページの文字列名 (例-Encoding "windows-1251") も使用できます。詳細については、Encoding.CodePage の .NET ドキュメントを参照してください。

Note

UTF-7* の使用は推奨されなくなりました。 PowerShell 7.1 の時点で、Encoding パラメーターに指定utf7すると警告が書き込まれます。

Type:	Encoding
Accepted values:	ASCII, BigEndianUnicode, BigEndianUTF32, OEM, Unicode, UTF7, UTF8, UTF8BOM, UTF8NoBOM, UTF32
Position:	Named
Default value:	UTF8NoBOM
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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 複数の入力の種類を持つパイプライン入力を処理していました。これで、パイプラインを通過する各オブジェクトが処理され、オブジェクトが隣接している場合を除き、オブジェクトはグループ化されません。

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

-LiteralPath

ファイルへの完全なパスを指定します。 LiteralPath の値は、型指定されたとおりに使用されます。このパラメーターは、ワイルドカード文字を受け入れません。ファイルへの複数のパスを指定するには、パスをコンマで区切ります。 LiteralPath パラメーターにエスケープ文字が含まれている場合は、パスを単一引用符で囲みます。 PowerShell では、単一引用符で囲まれた文字列内の文字はエスケープシーケンスとして解釈されません。詳細については、「about_Quoting_Rules」を参照してください。

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

-Offset

これは、16 進出力の一部からスキップするバイト数を表します。

このパラメーターは、PowerShell 6.2 で導入されました。

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

-Path

ファイルへのパスを指定します。現在の場所を指定するには、ドット (.) を使用します。ワイルドカード文字 (*) は受け入れられ、場所内のすべての項目を指定するために使用できます。 Path パラメーターにエスケープ文字が含まれている場合は、パスを単一引用符で囲みます。ファイルへの複数のパスを指定するには、パスをコンマで区切ります。

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

-Raw

このパラメーターは何も実行しなくなりました。スクリプトの互換性のために保持されます。

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

入力

String

このコマンドレットに文字列をパイプできます。

出力

ByteCollection

このコマンドレットは ByteCollection を 返します。このオブジェクトは、バイトのコレクションを表します。これには、バイトのコレクションを、返される出力の各行のように書式設定された文字列に変換するメソッドが Format-Hex含まれています。出力には、処理されているバイトの型も示されます。 Path または LiteralPath パラメーターを指定した場合、オブジェクトには各バイトを含むファイルのパスが含まれます。文字列、ブール値、整数などを渡すと、適切なラベルが付けられます。

メモ

PowerShell には、次のエイリアスが Format-Hex含まれています。

すべてのプラットフォーム:
- fhx

出力の右端の列は、バイトを ASCII 文字としてレンダリングしようとします。

一般に、各バイトは Unicode コードポイントとして解釈されます。これは、次のことを意味します。

印刷可能な ASCII 文字が常に正しくレンダリングされる
マルチバイト UTF-8 文字が正しくレンダリングされない
UTF-16 文字は、高次バイトが発生した場合にのみ正しくレンダリングされます NUL。

Format-Hex

構文

説明

例

例 1: 文字列の 16 進数表現を取得する

例 2: 16 進数の出力からファイルの種類を検索する

例 3: さまざまなデータ型の配列を書式設定する

パラメーター

-Count

-Encoding

-InputObject

-LiteralPath

-Offset

-Path

-Raw

入力

出力

メモ

フィードバック

その他のリソース

Format-Hex

構文

説明

例

例 1: 文字列の 16 進数表現を取得する

例 2: 16 進数の出力からファイルの種類を検索する

例 3: さまざまなデータ型の配列を書式設定する

パラメーター

-Count

-Encoding

-InputObject

-LiteralPath

-Offset

-Path

-Raw

入力

出力

メモ

関連リンク

フィードバック

その他のリソース