about_Character_Encoding

簡単な説明

PowerShell で文字列データの入力と出力に文字エンコードを使用する方法について説明します。

長い説明

Unicode は、世界中の文字エンコード標準です。 システムは、文字と文字列の操作にのみ Unicode を使用します。 Unicode のすべての側面の詳細については、 Unicode 標準を参照してください。

Windows では、Unicode 文字セットと従来の文字セットがサポートされています。 Windows コード ページなどの従来の文字セットでは、8 ビット値または 8 ビット値の組み合わせを使用して、特定の言語または地域の設定で使用される文字を表します。

PowerShell では、既定で Unicode 文字セットが使用されます。 ただし、いくつかのコマンドレットには、異なる文字セットのエンコードを指定できる Encoding パラメーターがあります。 このパラメーターを使用すると、他のシステムやアプリケーションとの相互運用性に必要な特定の文字エンコードを選択できます。

次のコマンドレットには、 Encoding パラメーターがあります。

• Microsoft.PowerShell.Management
  • Add-Content
  • Get-Content
  • Set-Content
• Microsoft.PowerShell.Utility
  • Export-Clixml
  • Export-Csv
  • Export-PSSession
  • Format-Hex
  • Import-Csv
  • Out-File
  • Select-String
  • Send-MailMessage

バイトオーダーマーク

バイトオーダー マーク (BOM) はデータに使用される Unicode エンコードを示すファイルまたはテキスト ストリームの最初の数バイトのUnicode シグネチャです。 詳細については、 Byte オーダー マーク ドキュメントを参照してください。

Windows PowerShell では、 UTF7を除く Unicode エンコードでは常に BOM が作成されます。 PowerShell (v6 以降) の既定では、すべてのテキスト出力に対して utf8NoBOM されます。

全体的な互換性を最大限に高める場合は、UTF-8 ファイルで BOM を使用しないでください。 Windows プラットフォームでも使用される Unix プラットフォームと Unix-heritage ユーティリティは、BOM をサポートしていません。

同様に、 UTF7 エンコードは避ける必要があります。 UTF-7 は標準の Unicode エンコードではなく、すべてのバージョンの PowerShell で BOM なしで記述されます。

Unix に似たプラットフォームで PowerShell スクリプトを作成するか、Visual Studio Code などの Windows 上のクロスプラットフォーム エディターを使用すると、 UTF8NoBOMを使用してファイルがエンコードされます。 これらのファイルは PowerShell では正常に動作しますが、ファイルに Ascii 以外の文字が含まれている場合は、Windows PowerShell で破損する可能性があります。

スクリプトで Ascii 以外の文字を使用する必要がある場合は、BOM で UTF-8 として保存します。 BOM がないと、Windows PowerShell では、スクリプトが従来の "ANSI" コードページでエンコードされていると誤って解釈されます。 逆に、UTF-8 BOM を持つファイルは Unix に似たプラットフォームで問題になる可能性があります。 cat、sed、awkなどの多くの Unix ツールや、geditなどの一部のエディターでは BOM の処理方法がわかりません。

Windows PowerShell での文字エンコード

PowerShell 5.1 では、 Encoding パラメーターは次の値をサポートしています。

• Ascii Ascii (7 ビット) 文字セットを使用します。
• BigEndianUnicode ビッグ エンディアンバイト順で UTF-16 を使用します。
• BigEndianUTF32 ビッグ エンディアンバイト順で UTF-32 を使用します。
• Byte 文字のセットをバイト シーケンスにエンコードします。
• Default システムのアクティブなコード ページ (通常は ANSI) に対応するエンコードを使用します。
• Oem システムの現在の OEM コード ページに対応するエンコードを使用します。
• String Unicode と同じです。
• Unicode リトル エンディアン バイト順で UTF-16 を使用します。
• Unknown Unicode と同じです。
• UTF32 リトル エンディアンバイト順で UTF-32 を使用します。
• UTF7 UTF-7 を使用します。
• UTF8 UTF-8 (BOM あり) を使用します。

一般に、Windows PowerShell では既定で Unicode UTF-16LE エンコードが使用されます。 ただし、Windows PowerShell のコマンドレットで使用される既定のエンコードは一貫性がありません。

ファイルに出力を書き込むコマンドレットの場合:

• Out-Fileリダイレクト演算子は UTF-16LE を作成>>>。これは特にSet-ContentやAdd-Contentとは異なります。

• New-ModuleManifest UTF-16LE ファイルも作成 Export-Clixml 。

• ターゲット ファイルが空の場合、または存在しない場合は、エンコードSet-Content使用Add-ContentDefault。 Default は、アクティブなシステム ロケールの ANSI レガシ コード ページで指定されたエンコードです。

• Export-Csv は Ascii ファイルを作成しますが、 Append パラメーターを使用する場合は異なるエンコードを使用します (下記参照)。

• Export-PSSession では、既定で BOM を含む UTF-8 ファイルが作成されます。

• New-Item -Type File -Value では、BOM レス UTF-8 ファイルが作成されます。

• Send-MailMessage では、既定で Ascii エンコードが使用されます。

• Start-Transcript では、BOM を使用 Utf8 ファイルが作成されます。 Append パラメーターを使用すると、エンコードが異なる場合があります (下記参照)。

既存のファイルに追加するコマンドの場合:

• Out-File -Append および >> リダイレクト演算子は、既存のターゲット ファイルのコンテンツのエンコードを照合しようとしません。 代わりに、 Encoding パラメーターを使用しない限り、既定のエンコードが使用されます。 コンテンツを追加するときは、ファイルの元のエンコードを使用する必要があります。

• 明示的な Encoding パラメーターがない場合、 Add-Content は既存のエンコードを検出し、新しいコンテンツに自動的に適用します。 既存のコンテンツに BOM がない場合は、 ANSI エンコードが使用されます。 Add-Contentの動作は PowerShell (v6 以降) でも同じですが、既定のエンコードはUtf8。

• Export-Csv -Append は、ターゲット ファイルに BOM が含まれている場合に、既存のエンコードと一致します。 BOM がない場合は、 Utf8 エンコードが使用されます。

• Start-Transcript -Append は、BOM を含むファイルの既存のエンコードと一致します。 BOM がない場合、既定ではエンコードが Ascii されます。 トランスクリプト内のデータにマルチバイト文字が含まれている場合、このエンコードによりデータが失われたり、文字が破損したりする可能性があります。

BOM がない場合に文字列データを読み取るコマンドレットの場合:

• Get-Content Import-PowerShellDataFileでは、Default ANSI エンコードが使用されます。 ANSI は、PowerShell エンジンがファイルからソース コードを読み取るときにも使用します。

• Import-Csv、 Import-Clixml、および Select-String BOM がない場合は Utf8 を想定しています。

PowerShell での文字エンコード

PowerShell (v7.1 以降) では、 Encoding パラメーターは次の値をサポートしています。

• 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 形式 (BOM なし) でエンコードします。
• utf8BOM: バイト オーダー マーク (BOM) を使用して UTF-8 形式でエンコードします。
• utf8NoBOM: バイト オーダー マーク (BOM) を使用せずに UTF-8 形式でエンコードします。
• utf32: リトル エンディアンバイト順を使用して UTF-32 形式でエンコードします。

PowerShell の既定では、すべての出力に対して utf8NoBOM されます。

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

PowerShell 7.4 以降では、ANSI パラメーターの値を使用して、手動で指定しなくても、現在のカルチャの ANSI コード ページの数値 ID を渡すことができます。

既定のエンコードの変更

PowerShell には、既定のエンコード動作を変更するために使用できる 2 つの既定の変数があります。

• $PSDefaultParameterValues
• $OutputEncoding

詳細については、「 about_Preference_Variables」を参照してください。

PowerShell 5.1 以降では、リダイレクト演算子 (> と >>) は、 Out-File コマンドレットを呼び出します。 そのため、次の例に示すように、 $PSDefaultParameterValues 基本設定変数を使用して、それらの既定のエンコードを設定できます。

$PSDefaultParameterValues['Out-File:Encoding'] = 'utf8'

次のステートメントを使用して、 Encoding パラメーターを持つすべてのコマンドレットの既定のエンコードを変更します。

$PSDefaultParameterValues['*:Encoding'] = 'utf8'

自動変数 $OutputEncoding は、PowerShell が外部プログラムとの通信に使用するエンコードに影響します。 出力リダイレクト演算子と PowerShell コマンドレットがファイルへの保存に使用するエンコードには影響しません。

こちらも参照ください

• about_Preference_Variables
• バイトオーダーマーク
• コード ページ - Win32 アプリ
• Encoding.CodePage
• .NET での文字エンコードの概要
• Unicode 標準
• UTF-16LE