PowerShellの基本 — コマンドプロンプトとの違いと、オブジェクトを渡すパイプ

PowerShellの基本。青いターミナルとデータのカード、カードを運ぶパイプ。

このサイトの記事は、ほぼ全部 PS> から始まります。VM を立てるのも、証明書を見るのも、サーバーの状態を確かめるのも、最初の1行は Windows の PowerShell です。それなのに、PowerShell そのものの回がありませんでした。

そして、書きながら何度も同じところで手が止まりました。curl と打つと、curl ではないものが動く。 ls の結果を grep に渡せない。ファイルに書き出したら、Linux 側で読めない。どれも「Linux のつもりで打った」ことが原因です。

この記事は、PowerShell を「Windows 版の bash」だと思うのをやめる回です。1つだけ違いを覚えれば、残りは全部そこから説明が付きます。

対象レベル: PC入門 / 区分: 必修

目次

この記事でわかること

  • パイプを流れているのが文字列ではないこと。そこから何が変わるか
  • 知らないコマンドを3つの動詞で自力で調べるやり方
  • curl ls wget が別物にすり替わっていること(このサイトが curl.exe と書く理由)
  • 文字コードの既定は測って確かめること。バージョンで変わる
  • スクリプトが「実行できません」と言われたときに、何を緩めて何を緩めないか

この記事でやること

  1. いま自分がどの PowerShell を使っているのか確かめる
  2. 同じ処理を「文字列として」と「オブジェクトとして」の両方で書いて、違いを見る
  3. 調べ方の3つの動詞を、実際に打って覚える
  4. ファイルの文字コードを、バイト列で確かめる
  5. スクリプトを1本置いて、実行ポリシーに引っかかり、直す

先に知る言葉

この記事で初めて出てくる言葉です。 詳しくは用語集にもまとめてあります。

言葉意味
コマンドレットPowerShell に組み込まれたコマンド。動詞-名詞 の形をしている(Get-Process)
オブジェクト「名前」「CPU」「ID」のように項目を持った値。文字列ではない
プロパティオブジェクトが持っている項目。$p.Name の Name の部分
エイリアスコマンドの別名。ls は Get-ChildItem の別名
実行ポリシースクリプトファイルを実行してよいかの設定。安全機能であって、権限ではない

① いま、どの PowerShell を使っているのか

Windows には PowerShell が2つ入ります。 見た目がほとんど同じで、中身が違います。

PS> $PSVersionTable.PSVersion
PS> $PSVersionTable.PSEdition
Major  Minor  Build  Revision
-----  -----  -----  --------
5      1      26100  ...

Desktop
Windows PowerShell 5.1PowerShell 7
EditionDesktopCore
実行ファイルpowershell.exepwsh.exe
入っているかWindows に最初から入っている自分で入れる
更新もう機能追加されない続いている
curl と打つとInvoke-WebRequest が動く本物の curl.exe が動く

2つは共存できます。 消し合いません。7 を入れる場合はこれだけです。

PS> winget install --id Microsoft.PowerShell -e
PS> pwsh -NoLogo -Command '$PSVersionTable.PSVersion'

このサイトの記事は 5.1 を前提に書いています。 追加インストールなしで全員の手元にあるからです。7 で読み替えるときに困るのは、あとで出てくるエイリアスと文字コードの2か所だけです。

② パイプを流れているのは文字列ではない

ここだけ理解すれば、残りは全部そこから出てきます。

Linux のパイプは文字列を渡します。だから grep や awk のような「文字列を切る道具」が要ります。PowerShell のパイプはオブジェクトを渡します。切る必要がないので、項目の名前で直接指定できます。

【Linux】  文字列 ──→ 切る(awk '{print $2}') ──→ 使う
【PS】     オブジェクト ─────────────────→ .Name で使う

実際に見る

まず、流れているものの正体を確かめます。

PS> Get-Process | Get-Member -MemberType Property | Select-Object -First 8
   TypeName: System.Diagnostics.Process

Name             MemberType Definition
----             ---------- ----------
BasePriority     Property   int BasePriority {get;}
Handle           Property   System.IntPtr Handle {get;}
Id               Property   int Id {get;}
...

Get-Member は、この記事で一番よく使うコマンドです。 「いま何が流れているのか」を、必ずこれで確かめます。画面に表示されているのはそのオブジェクトの一部を表にしたもので、持っている項目はもっと多いことがよくあります。

絞る・選ぶ・並べる

PS> Get-Process |
PS>   Where-Object WorkingSet -gt 200MB |
PS>   Select-Object Name, Id, @{n='MB';e={[math]::Round($_.WorkingSet/1MB)}} |
PS>   Sort-Object MB -Descending |
PS>   Select-Object -First 5
Name         Id   MB
----         --   --
msedge     12345  842
Code        6789  611
...

1行も文字列を切っていません。 200MB のような単位がそのまま書けるのも、比べている相手が文字列ではなく数値だからです。

やりたいことLinuxPowerShell
絞るgrepWhere-Object
列を取るawk '{print $2}'Select-Object 名前
並べるsortSort-Object
数えるwc -lMeasure-Object
1件ずつ処理while readForEach-Object

比較の書き方が違う

> は「より大きい」ではありません。リダイレクトです。 比較は文字で書きます。

書き方意味
-eq / -ne等しい / 等しくない
-gt / -lt / -ge / -le大なり / 小なり / 以上 / 以下
-likeワイルドカード(* ?)で照合
-match正規表現で照合
-contains配列がその要素を含む
PS> "abc" -like  "a*"      # True
PS> "abc" -match "^a.c$"   # True
PS> 1 -eq "1"              # True  ← 左の型に合わせて変換される

比較は「左の型」に合わせて変換されます。 JavaScript の == の回でやったのと同じ落とし穴が、ここにもあります。$null と比べるときは if ($null -eq $x) と左に $null を置くのが定石です。逆に書くと、$x が配列のときに要素ごとの比較になって、期待と違う答えが返ります。

表示は最後だけ

Format-Table を途中に入れると、そこから先はオブジェクトではなくなります。

PS> Get-Process | Format-Table Name, Id | Sort-Object Name   # 期待どおりに並ばない
PS> Get-Process | Sort-Object Name | Format-Table Name, Id   # 正しい

Format-* は「画面に出すための指示」に変換してしまうため、パイプの最後にだけ置きます。

③ 調べ方は3つの動詞で足りる

PowerShell のコマンドは数千あります。覚えるのではなく、引けるようにします。

コマンドいつ使うか
Get-Commandそのコマンドはあるか/名前が思い出せない
Get-Helpどう使うか/使用例が見たい
Get-Memberいま何が流れているか/どんな項目を持っているか
PS> Get-Command *service*              # 名前で探す
PS> Get-Command curl                    # その名前で何が動くのか確かめる
PS> Get-Help Get-Service -Examples      # 使用例だけ見る
PS> Get-Service | Get-Member            # 流れているものの中身

Get-Command <名前> は、事故を1つ確実に防ぎます。 打とうとしているものが本物かどうかを、打つ前に確かめられるからです。

④ curl は curl ではない

Windows PowerShell 5.1 で、そのまま打ってみます。

PS> Get-Command curl
CommandType  Name  Definition
-----------  ----  ----------
Alias        curl  Invoke-WebRequest

curl ではありません。 Invoke-WebRequest の別名です。オプションの書き方が違うので、Linux の記事に載っている curl -I をそのまま打つと、意味の分からないエラーになります。

打った名前5.1 で動くもの本物を使うには
curlInvoke-WebRequestcurl.exe
wgetInvoke-WebRequestcurl.exe -O
lsGet-ChildItem—(別物でよい)
catGet-Content—
rmRemove-Item—

これが、このサイトの記事が curl.exe と書いている理由です。 .exe を付けると、エイリアスを飛ばして実物が動きます。curl.exe は Windows 10 以降に標準で入っています。

PS> curl.exe -s -I https://obmes.com/

PowerShell 7 では curl と wget のエイリアスが削除されました。 つまり 7 では curl がそのまま本物です。どちらでも動く書き方が curl.exe なので、記事や手順書には常にこちらを書くのが安全です。

外部コマンドの成否は、別の変数で見る

curl.exe のような外部の実行ファイルは、PowerShell のコマンドレットとは成否の伝え方が違います。

PS> curl.exe -s -o NUL -w "%{http_code}" https://obmes.com/nothing
PS> $LASTEXITCODE      # 外部コマンドの終了コード
PS> $?                  # 直前が成功したか(コマンドレット向け)

404 が返っても curl.exe 自体は成功しているので、$LASTEXITCODE は 0 です。「通信できたか」と「相手が何を返したか」は別、というのは HTTP の回でやったとおりです。

⑤ 文字コードは、測って確かめる

ここが Linux と行き来するときに一番刺さります。 しかも、バージョンと使うコマンドで既定が変わります。 覚えるのではなく、そのつど確かめるのが確実です。

PS> "テスト" | Out-File a.txt
PS> "テスト" | Set-Content b.txt
PS> "テスト" | Out-File -Encoding utf8 c.txt

PS> foreach ($f in "a.txt","b.txt","c.txt") {
PS>   $b = [IO.File]::ReadAllBytes($f)[0..3]
PS>   "{0}: {1}" -f $f, (($b | ForEach-Object { $_.ToString('X2') }) -join ' ')
PS> }
a.txt: FF FE C6 30
b.txt: 83 65 83 58
c.txt: EF BB BF E3

3つとも中身が違います。 先頭の数バイトだけで見分けられます。

先頭正体Linux 側で読むと
FF FEUTF-16LE(BOM 付き)1文字おきに空白が入ったように見える
EF BB BFUTF-8(BOM 付き)先頭に見えない3バイトが混ざる
いきなり 83 などCP932(日本語 Windows の既定)文字化けする
いきなり E3 などUTF-8(BOM なし)そのまま読める

BOM 付き UTF-8 は「読めるのに壊れる」ので一番厄介です。 Git の回で git diff の先頭に見えない文字が出たのも、YAML や JSON が「1行目でエラー」になるのも、たいていこれです。

迷ったら、自分の環境で上のバイト列を1回出してください。 PowerShell 7 は既定が BOM なし UTF-8 ですが、5.1 は違います。「記事にこう書いてあった」ではなく、手元の 3 バイトを見るほうが速くて確実です。

Linux へ渡すファイルの書き方

PS> $utf8NoBom = New-Object System.Text.UTF8Encoding $false
PS> [IO.File]::WriteAllText("$PWD\d.txt", "テスト`n", $utf8NoBom)
PS> [IO.File]::ReadAllBytes("d.txt")[0..2] | ForEach-Object { $_.ToString('X2') }
E3
83
86

BOM が付いていません。 改行も `n(LF)にしてあります。VS Code から VM を触る回でやったように、行き先が Linux なら LF・BOM なしが原則です。

⑥ スクリプトが「実行できません」と言われる

ファイルに書いて実行しようとすると、たいてい最初に止められます。

PS> Set-Content check.ps1 'Get-Date'
PS> .\check.ps1
.\check.ps1 : このシステムではスクリプトの実行が無効になっているため、
ファイル ...\check.ps1 を読み込めません。

これは権限の問題ではありません。 実行ポリシーという別の仕組みで、「うっかり拾ったスクリプトを実行してしまう」事故を減らすための安全装置です。管理者になっても、そのままでは変わりません。

PS> Get-ExecutionPolicy -List
設定意味
Restrictedスクリプトを一切実行しない(クライアント Windows の既定)
RemoteSigned自分で書いたものは実行する。ネットから来たものは署名が要る
AllSigned全部に署名が要る
Bypass何も確認しない。常用しない
PS> Set-ExecutionPolicy -Scope CurrentUser RemoteSigned
PS> .\check.ps1

-Scope CurrentUser を付けてください。 付けないと機械全体の設定を変えることになり、他の利用者やサービスにも効きます。緩めるときは、必要な範囲だけ緩める——ファイアウォールの回や権限の回と、まったく同じ考え方です。

ネットから落としたファイルは、実行ポリシーとは別に「ゾーン」の印が付きます。

PS> Get-Item .\check.ps1 -Stream Zone.Identifier   # 印があるか見る
PS> Unblock-File .\check.ps1                        # 中身を読んでから外す

先に中身を読んでください。 Unblock-File は「このファイルは信用する」と宣言する操作です。

⑦ 端末そのものを、少しだけ整える

Windows Terminal は「新しいコマンドプロンプト」ではなく、複数の端末をタブで開くための入れ物です。 PowerShell 5.1・PowerShell 7・WSL・VM への SSH を、同じ窓のタブで並べられます。

PS> winget install --id Microsoft.WindowsTerminal -e

入れたら、覚えるのは4つだけです。

操作キー
新しいタブCtrl + Shift + T
左右に分割Alt + Shift + +
タブを閉じるCtrl + Shift + W
設定(JSON)を開くCtrl + Shift + ,

履歴を引く

Ctrl + R で、過去に打ったコマンドを検索できます。 bash と同じです。履歴はファイルに残っていて、場所はこれで分かります。

PS> (Get-PSReadLineOption).HistorySavePath

これはただのテキストファイルです。 パスワードや API キーをコマンドの引数に書くと、そのままここに残ります。秘密は引数に書かず、Read-Host -AsSecureString で受け取るか、環境変数から読むようにしてください。

プロファイル(起動時に読まれるファイル)

PS> $PROFILE
PS> if (-not (Test-Path $PROFILE)) { New-Item -ItemType File -Path $PROFILE -Force }
PS> notepad $PROFILE

最初は何も書かなくて構いません。 増やすほど「自分の機械でしか動かない手順」が増えます。書くとしても、この程度で足ります。

Set-PSReadLineOption -PredictionSource History
$PSDefaultParameterValues['Out-File:Encoding'] = 'utf8'   # 5.1 では BOM 付き UTF-8。Linux へ渡すファイルは別途 BOM なしで書き出す

完成の判定

次の5つを、出力で示せたら合格です。

#確かめることコマンド
1自分が使っている版が分かる$PSVersionTable
2curl の正体が分かるGet-Command curl
3文字列を切らずに絞り込めるGet-Process | Where-Object …
4書き出したファイルの文字コードが言える先頭 3 バイトの表示
5自作スクリプトを実行できる.\check.ps1

つまずいたところ

2>&1 を付けたら、成功したのに失敗扱いになった

Windows PowerShell 5.1 で、外部の実行ファイルに対して 2>&1 を付けたときに起きます。 標準エラーの各行がエラーオブジェクトとして包まれるため、終了コードが 0 でも $? が False になります。

PS> git --version 2>&1 ; $?          # False になることがある
PS> git --version      ; $LASTEXITCODE # 0(こちらが本当の成否)

外部コマンドの成否は $LASTEXITCODE で見てください。 そもそも 2>&1 を付けないほうが、面倒がありません。

&& と || が使えない

5.1 には無い記法です(7 で追加されました)。5.1 では次のように書きます。

PS> コマンドA; if ($?) { コマンドB }     # A が成功したら B
PS> コマンドA; コマンドB                  # 成否に関係なく続ける

空白の入ったパスで、実行ファイルが起動しない

PS> "C:\Program Files\Git\bin\git.exe" --version    # 文字列として表示されるだけ
PS> & "C:\Program Files\Git\bin\git.exe" --version  # 実行される

引用符で囲むと、ただの文字列になります。 頭に &(呼び出し演算子)を付けると実行されます。

変数を文字列に混ぜたら、変なものが出た

PS> $p = Get-Process -Id $PID
PS> "名前: $p.Name"          # → 名前: System.Diagnostics.Process(...).Name
PS> "名前: $($p.Name)"       # → 名前: pwsh

プロパティを取り出すときは $( ) で囲みます。 二重引用符の中では、$p までしか変数として読まれません。

Get-Content が遅い

1行ずつオブジェクトにしているためです。巨大なログを扱うときは、行数を絞るか、まとめて読みます。

PS> Get-Content big.log -Tail 100          # 最後の100行だけ
PS> Get-Content big.log -Raw                # 1つの文字列としてまとめて読む
PS> Select-String "ERROR" big.log           # grep 相当(これは速い)

後片づけ

PS> Remove-Item a.txt, b.txt, c.txt, d.txt, check.ps1 -ErrorAction SilentlyContinue

実行ポリシーは戻さなくて構いません。 RemoteSigned は、自分で書いたスクリプトを動かしつつ、拾ってきたものを止める設定です。ここから先の回でも使います。

よくある質問

PowerShell 7 を入れるべきですか。5.1 のままでもいいですか
このサイトの記事は 5.1 で全部動くので、急いで入れる必要はありません。7 を入れる価値があるのは、文字コードの既定が BOM なし UTF-8 になること、パイプライン演算子が使えること、Linux や macOS でも同じものが動くことです。両方を共存させられるので、まず 5.1 で慣れて、必要になったときに入れるのが無駄がありません。
Linux のコマンドをそのまま打ちたいのですが、どうすればいいですか
WSL を入れて、Linux 側で打つのが素直です。PowerShell 上のエイリアスは名前が同じだけで別のコマンドなので、オプションの互換性はありません。Windows 側でどうしても本物を使いたい場合は、curl.exe のように拡張子まで書いて実物を呼びます。ただし記事の手順を追うだけなら、無理に合わせず PowerShell の書き方で覚えたほうが、あとで役に立ちます。
実行ポリシーを Bypass にしてはいけませんか
常用しないでください。Bypass は確認を一切しない設定で、ネットから落ちてきたスクリプトも警告なく実行されます。自分で書いたものを動かしたいだけなら RemoteSigned で足ります。CI やインストーラの中で一時的に使うことはありますが、その場合も -Scope Process のようにその場限りにして、機械全体の設定は変えないようにします。
書き出したファイルが Linux で文字化けします
文字コードと改行コードの両方を確認してください。まず先頭の数バイトを表示して、FF FE なら UTF-16、EF BB BF なら BOM 付き UTF-8、いきなり 83 のような値なら CP932 です。Linux へ渡すなら BOM なし UTF-8 と LF にします。記事にある WriteAllText の書き方を使うと、両方まとめて指定できて確実です。
コマンドを覚えきれません
覚えなくて構いません。PowerShell のコマンドは動詞と名詞の組み合わせなので、Get-Command で名前を探し、Get-Help で使い方を見て、Get-Member で中身を見る、という3つの引き方さえ身に付けば、知らないコマンドでもその場で調べられます。実際、この記事に出てくるコマンドの多くも、その3つで見つけられるものです。

まとめ — 理解できたこと

  • パイプを流れているのはオブジェクト。 だから文字列を切る道具が要らず、項目名で指定できる
  • 比較は -eq -gt のように文字で書く。 > はリダイレクト
  • Format-* はパイプの最後だけ。 途中に入れると、そこから先はオブジェクトではなくなる
  • curl wget は 5.1 では別物。 だから手順書には curl.exe と書く
  • 文字コードの既定はバージョンとコマンドで変わる。 覚えずに、先頭 3 バイトを見る
  • 実行ポリシーは権限ではなく安全装置。 緩めるなら CurrentUser の範囲だけ

参考リンク

次に読む

この記事は 【第0段階】作業場所を作る の 7 / 18 本目です。

記事
← 前の記事開発にPCの初期化は要らない — まず環境を測る
→ 次の記事初期状態のPCに入れるのは3つだけ — 何を入れないかの話

上から順に読めば積み上がるように並べています。 飛ばしても構いませんが、詰まったら前の回に戻ってください。

全体の順路は はじめに にあります。

よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!

コメント

コメントする

目次