PowerShellでps1ファイルに使う文字コードと改行コードについて

Last updated at 2021-11-04Posted at 2021-10-29

PowerShellといえば下記の2種類が存在しています。

Windows+.NET Frameworkを背景としたWindows PowerShell
cross platform+.NETを背景としたPowerShell

このようにWindowsPowerShellとPowerShellが混在する環境があった場合に利用するPowerShellスクリプトファイルの文字コードと改行コードについて考えてみます。

理想としては、一度書いたスクリプトは手直しせずに他の環境でも実行できると最高ですが。
現状は文字コードと改行コードがネックになり、これはなかなか難しいかと思います。

ドキュメント

適切なエンコードの選択

本記事を書くに当たって、調べていたら、MSDocsのPowerShellドキュメントの上記ページにエンコードについての記載がありました。

なんとなく感覚で理解してた部分についてまとめられていました。
下記引用。

主に Windows アプリケーションと Windows PowerShell を使用している場合は、BOM ありの UTF-8 または UTF-16 のようなエンコードをお勧めします。

複数のプラットフォームにまたがって作業する場合は、BOM ありの UTF-8 をお勧めします。

主に Linux 関連のコンテキストで作業する場合は、BOM なしの UTF-8 をお勧めします。

Windows-1252 とラテン-1 は基本的にレガシエンコードであり、できれば避けてください。ただし、一部の古い Windows アプリケーションではそれらに依存している可能性があります。

スクリプトの署名はエンコードに依存している点にも注意してください。つまり、署名されたスクリプトのエンコードを変更するには再署名が必要です。

改行コードについての記載はありませんが概ね下記のような理解で問題ないかと思います。

OSはWindowsを利用してWindows PowerShellを利用する場合　UTF8+BOM + CRLF。
OSはWindowsとLinuxのクロスプラットフォームでWindowsPowerShellとPowerShellが混在する場合 UTF8+BOM + CRLF
OSはLinuxだけでPowerShellのみ利用 UTF-8+BOMless + LF

各種文字コードのスクリプトがそれぞれのプラットフォームでどのように動作するか確認してみる

Windows 10 + WindowsPowerShell 5.1 で WindowsPowerShellプロンプトから実行
Windows 10 + PowrShell 7.1.5 でPowerShellプロンプトから実行
WSL(Ubuntu 20.04) + PowerShell 7.1.5　でBash（shebang）から実行
WSL(Ubuntu 20.04) + PowerShell 7.1.5　でPowerShellプロンプトから実行

の組み合わせでそれぞれどうなるか確認してみます。

用意するスクリプトの組み合わせは下記

UTF8+BOM + CRLF
UTF8+BOM + LF
UTF8+BOMLess + CRLF
UTF8+BOMLess + LF

UTF8-BOM-CRLF.ps1

#!/usr/bin/env pwsh

PROCESS {

    Set-StrictMode -Version Latest
    $ErrorActionPreference = "stop"

    Write-host "HelloWorld こんにちは世界
    on UFT8+BOM CRLF"

}

UTF8-BOM-LF.ps1

#!/usr/bin/env pwsh

PROCESS {

    Set-StrictMode -Version Latest
    $ErrorActionPreference = "stop"

    Write-host "HelloWorld こんにちは世界
    on UFT8+BOM LF"

}

UTF8-BOMLess-CRLF.ps1

#!/usr/bin/env pwsh

PROCESS {

    Set-StrictMode -Version Latest
    $ErrorActionPreference = "stop"

    Write-host "HelloWorld こんにちは世界
    on UFT8+BOMLess CRLF"

}

UTF8-BOMLess-LF.ps1

#!/usr/bin/env pwsh

PROCESS {

    Set-StrictMode -Version Latest
    $ErrorActionPreference = "stop"

    Write-host "HelloWorld こんにちは世界
    on UFT8+BOMLess LF"

}