更新版 10/25用

1. Windows Powershell
基礎 勉強会
2017/08/30(Wed) 自社・・・・第１回
2017/09/27(Wed) 自社・・・・第２回
山本 てつや

2. 山本 てつや (通称：ヤマゾン)
• 金融系システムの更改案件にて、
運用スクリプト、配布APの構築を
担当(2017/09〜)
• 最近の夢はRuby on RailsでWEBア
プリを作って、誰かに喜んでもら
うこと
• AWS (Yamazon Web Service)も勉
強中
• 今話題のWEBサイト、「
yamazoon.com 」の管理人

3. 目次
1. Powershellとは (他のスクリプト言語との比較)
2. Powershellを実行するための準備
3. 基本的なコマンドレットの使い方、書式
4. スクリプトの作り方、動かし方

4. 必要なもの
1. PC (Windows 7 以上のスペックであれば可)

5. 1. Powershellとは (他のスクリプト言語との比較)

6. インフラエンジニアから見たPowershell
1. WSH(VBS)に変わって登場した管理用スクリプト
言語
2. 高機能 (WSFC、Active Directory、Hyper-Vのモジ
ュールもある)
3. WinRMを使ったリモートサーバ管理が可能

7. 他の言語との比較

8. 1. バッチ (.cmd / .bat)
1. MS-DOS時代からある、今でも利用者の多いスクリプト
2. コマンドがたくさんあって結構なんでもできる
3. 実行ファイルや他のスクリプトを呼び出すのが得意
4. プログラミング言語で行うような構造的な文法記述には
不向き( for 文が独特だったり、エスケープが難しい)
5. 今後もOSバージョンに合わせて拡張され続ける★

9. 2. VBS (.vbs)
1. Visual Basic のスクリプト版で、兄弟はVBA
2. Windows歴の長い一定数の人から根強い人気
3. バッチで出来ないことをするために使うことが多
い
4. 今後拡張される予定はない★

10. 3. Jscript (.js)
1. JavascriptのMS版として、VBSと同時期に誕生
2. 現場では２〜３年に１回ぐらい見かける気がする (
かなり私見かも)
3. 今後拡張される予定はない★

11. 4. Powershell (.ps1)
1. 2006年に誕生した割と新しいスクリプト
2. 各社がPowershell用にコマンドレットを出している(例：AWS Tools
For Powershell、VMware PowerCLI)
3. 利用者数が急増中
4. 今後もOSバージョンに合わせて拡張され続ける★
5. GithubよりLinux,MacOS向けにも展開中
6. 標準で付属しているIDE (ISEエディタ) が便利

12. 参考：ISEエディタ
Powershellのアイコンを右
クリックすると出てくる

13. 補完機能
実行ボタン
検索機能
スクリプト記述エ
リア

14. リモートホストのPowershellに
接続

15. VBS vs Powershell

16. PowershellよりVBSを使うべき時
1. 今動いてるVBSが問題ない時(わざわざリファクタリングする必要ない)
2. Powershellが入っていない環境(WindowsXP,Windows Server 2003)のシステム管理
3. Powershellが入っていない環境に、Powershellをインストールするためのスクリプトを
作る時
4. メモリやCPUがかなり枯渇している中で、どうしても動かしたい処理がある時 (WSHの
方が動作エンジンが軽いため。)
(参考記事：https://mcpmag.com/articles/2015/03/19/vbscript-instead-of-powershell.aspx)

17. 凡例: ◎ : インストール済み
△ : インストール可能
- : 未対応
バージョン 1.0 2.0 3.0 4.0 5.0
Windows Server 2003
△
SP1
△
SP2
- - -
Windows Server 2003 R2
△
SP1
△
SP2
- - -
Windows Server 2008 -
△
SP1
△
SP2
- -
Windows Server 2008 R2 - ◎
△
SP1
△
SP1
△
SP1
Windows Server 2012 - - ◎ △ △
Windows Server 2012 R2 - - - ◎ △

18. バージョン 1.0 2.0 3.0 4.0 5.0
Windows XP x64 △ - - - -
Windows XP
△
SP2
△
SP3
- - -
Windows Vista △
△
SP1
- - -
Windows 7 - ◎
△
SP1
△
SP1
△
SP1
Windows 8 - - ◎ - -
Windows 8.1 - - - ◎ △
Windows 10 - - - - ◎

19. Powershell を実行するための準備

20. 準備
エクスプローラ開く ⇨ 「表示」⇨「拡張子を表示する」に設定

21. ・拡張子が表示されていればOK

22. ・試しに１つ、デスクトップに拡張子が.ps1のPowershellファイルを作る。
ダブルクリックすると、メモ帳で開く。

23. • GUIでは、右クリックし「Powershellで実行」を
クリックし実行できる

24. • コンソールでは、Powershell.exe の引数にPowershell
スクリプトのパスを指定して実行することができる

25. 実行ポリシー

26. 1. Powershell スクリプトを右クリックし、「
Powershell で実行」をクリックした際の動作

27. 2. Powershell.exe の引数にPowershell スクリプトを
指定して実行した際の動作

28. • 実行ポリシーの種類
項目
(主なもの)
説明
Restricted
実行できるスクリプトはありません。
PowerShell は対話モードでのみ使用可能です。
AllSigned
信頼できる発行元が署名したスクリプトのみを
実行できます。
RemoteSigned
ダウンロードしたスクリプトは信頼できる発行
元が署名した場合にのみ実行できます。デフォ
ルト。
Unrestricted
制限なし。すべての Windows PowerShell スク
リプトを実行できます。

29. 実行ポリシーは・・・
• Get-Executionpolicy コマンドレットにて確認可能
• Set-Executionpolicy コマンドレットにて変更可能
例：Unrestricted に設定
Set-Executionpolicy Unrestricted

31. ⇨ ローカルコンピュータの設定を恒久変更するため注意。

32. 一時的な実行ポリシー変更
※ローカルコンピュータの設定を恒久変更せずに、
指定したPowershellスクリプトだけを、指定したポリシーで実行する方法。

33. 1. バッチ(.bat /.cmd) 実行により起動する場合
• 下記のように記載したバッチを作成 (Call-Hello.ps1)
Powershell -Executionpolicy Unrestricted “C:¥Hello.ps1”

35. 2. ショートカットファイル実行により起動する場合
• ターゲットに下記のように記載したショートカットを作成
Powershell -Executionpolicy Unrestricted “C:¥Hello.ps1”

37. 3. Powershellスクリプトを対話モードから実行する場合
• Set-ExecutionPolicyの「-Scope」オプションに「
process」を指定する
Set-Executionpolicy <値> -Scope process

39. 基本的なコマンドレットの使い方、書式

40. コマンドレット
(動詞)-(名詞) の形式を取る。
動詞は主に「Get」か「Set」。

41. • Get-Command
• (コマンドレット一覧)を(参照)
• Set-Executionpolicy
• (実行ポリシー)を(設定)

42. • オプションの調べ方
• 先頭にman を付ける
例：man get-service
• 末尾に-? を付ける
例：get-date -?

44. Get-Serviceコマンドレットを用いて、BITS のサービス
状態を取得する例

45. 今月の1日の日付を取
得
2017/1/1を取得

46. コマンドレットの持つ、
プロパティとメソッド

47. プロパティ
特徴や性質に関する情報
• iPhoneで例えると下記のような情報
• バージョン (6、6S、SE、7)
• 色 (赤、黒、白)
• 容量 (32、64、128 GB)
• キャリア (au、docomo、Softbank)

48. メソッド
提供している操作
• iPhoneで例えると下記のような操作
• 導入済みアプリの起動
• 連絡先への通話
• 写真を撮る
• 音声での機能検索

49. • 各コマンドレットが持つプロパティ、
メソッドの調べ方
• パイプでGet-Memberに渡す
例：get-service | Get-Member

51. • プロパティの使い方
• コマンドレットを括弧() でくくって
、「.プロパティ名」
例：(Get-Childitem).fullname

52. • Get-Childitem (=dir) コマンドレットから、
fullnameプロパティを取得する例

55. 日付プロパティを取得

56. • メソッドの使い方
• コマンドレットを括弧() でくくって
、「.メソッド名(引数)」
例：(Get-Service -name “BITS”).start()

57. • Get-Serviceコマンドレットの start()
メソッドを使い、BITSのサービスを開
始する例

59. 今日の日付を
yyyyMMddで取得
今日の日付に10日加
算してyyyyMMddで取
得
今月の1日から1日引き算して
、先月の最終日をyyyyMMdd
で取得

60. エイリアス

61. 各コマンドレットに用意された省略系。
Unixのコマンドを意識して作られている。下記は抜粋。
ls ・・・・・Get-Childitem
cat ・・・・・Get-Content (gc)
sleep ・・・・Start-Sleep
mkdir ・・・・New-Item -type directory
cd ・・・・・Set-Location
pushd・・・・Push-Location
popd ・・・・Pop-Location

62. cp ・・・・・Copy-Item
mv ・・・・・Move-Item
rm ・・・・・Remove-Item
clear (cls) ・・Clear-Host
ps ・・・・・Get-Process
kill ・・・・・Stop-Process
pwd ・・・・Get-Location
tee ・・・・Tee-Object
wget (curl) ・・Invoke-WebRequest

66. コマンドレットの出力行数を指定

67. • (コマンドレット)[n]
• n は 0 から始まる数字で、0を指定すると1行目の出
力が取れる
• Get-Childitem (ls) の出力結果より、1行目を取得
する例
(Get-Childitem)[0]

69. • (コマンドレット)[n..o]
• n行目〜o行目の出力が取れる
• Get-Childitem (ls) の出力結果より、1行目
〜4行目を取得する例
(Get-Childitem)[0..3]

71. • (コマンドレット)[-1]
• 最終行の出力が取れる
• Get-Childitem (ls) の出力結果より、最終
行を取得する例
(Get-Childitem)[-1]

73. おまけ①：Get-Childitem のfullnameプロパティにつ
いて、1行目、最終行を出力する例

74. おまけ②：プロパティやメソッドにも、プロパティや
メソッドは付いており(Get-Memberで確認できる)、使う
ときにはピリオドでつなげる。

75. おまけ③： Lengthプロパティは出力行数を返すプロパティ。
しかし、出力が1行のときは1行中の文字数を返す。一方Count
プロパティは基本的に出力行数を返す。
7行
7行
7行
5文字
1行

76. 変数

77. ${VAL} の形式を取る。
$VAL とも記述可能。

78. スコープ (ほんの少しだけ厄介)
• global・・・スクリプト外も可
• script・・・スクリプト内 ※デフォルト
• local・・・同一ブロック内・子ブロック内
• private・・同一ブロック内

79. • 使い方
• $script:valname

80. 親ブロック内
子ブロッ
ク内
親ブロック内でprivateとして定義した
$pは子ブロックでは参照不可
親ブロックの外では、親ブロック内で
scripとして定義した
$sのみ参照可

81. スコープについて補足
• 変数(A)を子ブロック(関数)で操作するとき
• 「+= 」だとローカル変数として変数(A)の値を
継承せずに、右辺が加算される。
• 「++」だと、ローカル変数として変数(A)の値
を継承し、右辺が加算される。

82. インクリメントされる
スコープを指定して参照すると、親スコープで定義した$aの値は変更
されていないとわかる
++

83. 300にはならずに、値を200として、
新たなローカル変数が作成される
+=200

84. そもそも、スコープを意識しなきゃいけないほど
階層的なスクリプトを書かないこと。
親ブロックで定義した変数を子ブロックで参照し
たり、書き換えするときは、スコープを書くよう
にする (例：$script:a += 1)。
また、親ブロックで定義したものと同じ名前の変
数を子ブロックで使わないようにする。
⇨抑えるべき点

85. 型
⇨代入すると自動で型変換される
• $a = 1 # ⇦System.Int32 (数値)
• $b = "1" # ⇦System.String (文字列)
• $a + $b # ⇦2 ※先の$aの型に $bが変換される
• $b + $a # ⇦11 ※先の$bの型に $aが変換される

87. 型指定して代入することも可能
※異なる型での上書き禁止になる
• [int32]$a = 1 # ⇦System.Int32 (数値)
• [int32]$b = "1" # ⇦System.Int32 (数値)
• [string]$b = "1" # ⇦System.String (文字列)
• [string]$b = 1 # ⇦System.String (文字列)

89. 変数でなくても、先の型が優先される

90. • 型の調べ方
• 「変数名.gettype()」
例：$a.gettype()

93. 型の変換
int32型(数値)に変換
• $a = $a -as [int32]
string型(文字列)に変換
• $a = $a -as [string]

95. 変数にもプロパティやメソッドは存在。
⇨パイプラインで Get-Member コマンドレ
ットに渡して調べる

96. 文字列型

98. 数値型

100. コマンドの出力結果を変数に代入する
• 例
• $a = ls
• $a = (ls)[0]

102. a.txt の末尾に、
yyyyMMdd形式の日付を付与する例
※ログローテーションなどに使用

103. フルパス
拡張子
フォルダパス
拡張子無しのファイル名
日付(yyyyMMdd)
名称変更する処理

104. net config workstation の実行結果から、所属し
ているドメイン名を変数格納する
※下の場合は「WORKGROUP」

106. バッチでドメイン名を変数格納してみる
※インタラクティブに動かす場合は ”%1” だが、バッチ
ファイルとして動かす場合は “%%1” と書く。

107. for /f "tokens=3" %1 in ('net config
workstation ^|findstr /R
/c:"^Workstation.*domain.*$"') do
set domainname=%1

108. 配列

109. 配列
• $list = @() # ⇦ 空配列作成
• $list = 1,2,3,4 # ⇦ 要素入り配列作成
• $list += 5,6,7,8 # ⇦要素追加①
• $list += 9,”string” # ⇦要素追加②

111. 文字列演算子・・・文字列として比較し、一致したものを出力
。
• -match # 正規表現比較
• -notmatch # 正規表現比較(不一致)
• -like # ワイルドカード比較
• -notlike # ワイルドカード比較(不一致)
• -replace # 置換

113. 比較演算子・・・数値として比較し、一致したものを出力。
• -eq # 左辺が右辺と等しい
• -ne # 左辺が右辺と等しくない
• -ge # 左辺が右辺と等しい、または右辺より大きい
• -gt # 左辺が右辺より大きい
• -le # 左辺が右辺と等しい、または右辺より小さい
• -lt # 左辺が右辺より小さい

115. おまけ：配列ではオブジェクトへのリファレンスを保持している

116. 連想配列
• $hash = @{} # ⇦ 空配列作成
• $hash = @{key1=value1} # ⇦ 要素入り配列作成
• $hash += @{key1=value1; key2=value2} # ⇦要素追加①
• $hash[key3] = value3 # ⇦要素追加②
• $hash[key3] = new-value3 # ⇦値変更
• $hash.key1 # ⇦値取り出し

120. 変数、配列の削除
• $a を削除する場合
• Remove-Variable a

122. 使用している変数・配列の確認
• Get-Variable

124. 入出力

125. • 標準出力
• Write-Output “Hello”
• echo “Hello”
• “Hello”
• 標準入力
• Read-Host

127. • ファイル出力
• “Hello” |out-file Hello.txt
• “漢字” |out-file 漢字.txt -encoding unicode
※漢字は文字化けするのでunicodeに変換する
• ファイル入力
• gc Hello.txt # gc はGet-Contentのエイリアス
• gc 漢字.txt

129. 標準出力(>)をNORMAL.logに、
標準エラー出力(2>)をERROR.logに出力
リダイレクトも使えます！

130. 標準出力の切り替えによく使うリダイレクト記号「>」は、
「1>」の省略形。
1> ・・・・標準出力
2> ・・・・標準エラー出力
※1番目のファイル記述子、という意味です。
同じ意味

131. 標準出力(>)をC:¥All.logに入れて、
そのあとに標準エラー出力(2>)を、
標準出力に混ぜる(&1)・・・・と、いつかの私は覚えました
。
>logfile 2>&1

132. ちなみに、順番を入れ替える(2>&1 >logfile)と、うまく動きま
せん。
コマンドの出力は標準出力が先に出るからです。
なので正しくは・・・・「先に出てきた標準出力(>)をlogfile
に入れて、
次に出る標準エラー出力(2>)を、標準出力に混ぜる(&1)。」
です。

133. と思ったら動いてる・・・・
Powershellすごい・・・
でもシェルスクリプトだと動かないから、
極力 ”>logfile 2>&1” と書きましょう。

134. 参考：シェルスクリプトだと動きが変わる例

135. • 特殊文字(よく使うもの)
• エスケープ文字「`」
• 改行「`n」
• キャリッジリターン「`r」
• タブ「`t」

136. Windowsの改行(CRLF)を特殊文字で表現
CR=`r
LF=`n
Windowsの改行(CRLF)をタブに置換
タブ=`t

137. number.txtの1111を7777に置換

138. Windowsの改行(CRLF)を####に置換した
はずが、
変わらない・・・・

139. 解説：cat (Get-Content) は改行(CRLF)を区切りにして、
1行ずつ読み込み表示している。
そのため、読み込んだテキストの改行(CRLF)は
既に取り除かれているため置換できない。

140. cat (Get-Content)の出力結果を、Out-Stringコマンドレッ
トに渡す。
Out-Stringコマンドレットは受け取った出力を、
「ひとまとまりの文字列」
として出力する。

141. 出力結果は一見同
じ

142. cat (Get-Content) の出力から、行末のCRLFは、取
り除かれている

143. CR
LF
CR
LF
Out-String は受け取った出力を
「ひとまとまりの文字列」にする

144. • CSV出力
• dir |convertto-csv
• dir |export-csv dir.csv -encoding unicode
※コマンドの出力をCSV形式に変換
• CSV入力
• Import-Csv dir.csv
• (Import-Csv dir.csv).fullname # ヘッダ指定

145. 各プロパティ毎に列出力する

146. Export-CSV でファイル出力する前に
どういう形式で出力されるか
コンソール上で確認するときに使う
でも、わかりにくいよね・・・・

147. スクロールできる
Out-Gridview コマンドレ
ットで
ビュー表示できる。

148. パイプライン出力を操作する
(オブジェクト操作)

149. • Where-Object (エイリアス：?)
• パイプラインから渡されるオブジェクト
を１行ずつ特殊変数「 $_ 」に格納し、
スクリプトブロック内で比較を行い、結
果を出力する。比較には比較演算子、文
字列演算子を用いることができる。

150. • dirコマンドの出力結果から、名前(ファイル
名、フォルダ名)に「a」を含む行を抽出す
る例
dir | ? {$_.name -match “^.*a.*$” }

151. 正規表現(.*`.txt)に
一致したnameプロパティ
を取り出す。
※Where-Objectを使わない例

152. dirコマンドレットの出力結果の中で、
nameプロパティが、
正規表現(.*`.txt)に
一致したレコード(オブジェクト)を取
り出す。
※Where-Objectを使う
例

153. ? (Where-Object) を使うと、
コマンドレットの出力をフィルターで
きる。
フィルターして、そこからさらに必要
なプロパティを取り出すことが可能。

154. abcd.txt から”aaaa”を含む行を抜粋

155. • Foreach-Object (エイリアス：%)
• パイプラインから渡されるオブジェクト
を１行ずつ特殊変数「 $_ 」に格納し、
スクリプトブロック内で処理を行い、結
果を出力する。処理には標準のコマンド
レットを用いる。

156. パイプラインを経由して渡された各要
素を、
一つ一つ、
%{} 内のコマンド(echo “times:$_” )に
渡す。
$_ には各要素が入る。

157. dirコマンドレットの出力結果の
中から
各要素のfullnameプロパティを
出力

158. ? (Where-Object) と組み合わせ
ること多し。

159. • Measure-Object (エイリアス：measure)
• 数字リストの最大値、最小値、平均値、
合計値、要素数を算出する
• 行数を合計するオプションもある(-Line)

160. 1,2,3,4 の最大・最小値、合計、平
均を取得

161. 参考：ファイルサイズ取得

162. • Select-String
• 入力元のテキストやファイルから、指定
したテキストを検索する。unixのgrepコ
マンド。検索には正規表現を用いる。ま
たプロパティとして、一致した行の行番
号(linenumber)などを返す。

163. abcd.txt から”aaaa”を含む行を出力

164. abcd.txt から”abcd”を含む行の
行番号を出力
※0ではなく1から始まる

165. • Select-Object (エイリアス：select)
• プロパティ値を指定して取り出す。必要
な出力だけ参照したいときに使用。
export-csvのCSV出力サイズを小さくし
たいときに便利だったり。

166. 必要な列を抜粋できる

168. • Group-Object
• 入力オブジェクトを指定したプロパティ
値でグループ化する。

169. 配列を同じ要素でグループ
化
Aが一番多い(4回)

170. • Sort-Object
• 入力されたオブジェクトを昇順で並び替
え。降順にするときは -desc をつける。

171. 昇順で並び替え

172. 降順で並び替え

173. 構文

174. • For文
• 例：
for ($i=1;$i -le 10;$i++) {“$i 回目”}

175. 1から10まで1ずつ加算
(10までインクリメント)

176. 個人的に使ったことのある実例。
(次のスライドに続く)

177. 先月の1日から最終日(上の例では31日)までの
ログ(xxxx_yyyyMMdd.log)をローカルにコピーしてくる
。
$i -as [string]で文字列型に型変換し、
padleftメソッドで、10未満の数の前に”0”をつけている
。

178. 先月(2017/08)の1日から最終日(31日)
のログが取れる
※画面はechoしてるだけで実際にコピーは
してない

179. • while文
• 例：
while ($i -lt 10) {$i++;“$i 回目”}
do{$i++;“$i 回目”} while ($i -lt 10)

181. 特殊変数「$True」を用いた無限ループ。
netstat の結果から127.0.0.1を含むコネクシ
ョンを 1秒間隔で出力

182. • if文
• 文字列演算子や比較演算子を用いて比較する
• 例：
if ($i -lt 10) {“$i”} else {“over 10”}
if (“$i” -match “^a$”) {“$i”} else {“x”}

184. • switch文
• 文字列演算子や比較演算子を用いて比較する
• if文でいう「else」は、「default」 を使う
• 正規表現を使う際は -regex オプションを使う
• 例：
switch (“$a”) {
“a” {“a”}
default {“NOT a”}
}

185. 文字列比較
オプション無し 完全一致
-regex 正規表現
-wildcard ワイルドカード
-casesensitive 大文字小文字区
別

186. 数値比較
※一致したらbreakで抜
けることも可能(数値に
限らず)

187. ブール値比較

188. 課題

189. • 前提：Listener サービスの起動後、
Listener.logに、「Listener completed
notification to CRS on start」が出力されていな
い場合、Listenerが内部で起動ハングしていま
す。
• その場合、出力されていないことを検知し
て、処置としてListenerを再起動する必要が
あります。

190. • 課題：Listenerサービスの起動処理後に、「
Listener completed notification to CRS on start」
と出力されていれば、”OK”と出力し、出力され
ていなければ”NG”と出力する処理(問題の検知部
分)を作成してください。

191. • 条件：pid=xxxxで起動しました。」から３行(
リスニングしています・・・・）までは毎回
必ず出力されているものとします。

192. いちばん最後の起動。正常終了
。これをチェックしたい
Listener.log
最後から1回前の起動。正常終了

193. 類似サンプル

195. # 今回の資料で記載しきれなかったもの.md
エラー処理(try catch finally / trap)
終了コード設定、判定(exit n / $lastexitcode)
引数の受け取り方($Args[n] / Param= / オプション化)
.NetFrameworkの使い方

196. エラー処理

197. •エラー時に処理を止める？続ける？
• $ErrorActionPreference
• エラー発生時の動きを定義している特殊変数
項目
(主なもの)
説明
continue
赤文字でエラー内容を表示し、
処理を継続する ★デフォルト
silentlycontinue
赤文字でエラー内容を表示せずに、
処理を継続する
stop
赤文字でエラー内容を表示し、
処理を中断する

198. • 変更するには下記のようにする
$ErrorActionPreference = “stop”

199. ⇨ スクリプト先頭に記述すると、
スクリプトで使用しているコマンド全てに適用される。
(つまり、記述した箇所以降から適用される)
⇨各コマンドごとに制御することも可能。

200. 各コマンドごとに制御する
• オプションに -erroraction (エイリアス: -ea)を使う
• dir -erroraction “stop”
• dir -ea “stop”
• -erroraction はすべてのコマンドレットに存在する共通パラ
メータである。

201. • エラー時に処理を止めた後に、何かする

202. 1. スクリプトの途中でエラーが発生した場合に検知し
、
何かコマンドを実行する (trap)

203. trap {
1. エラー発生時に実行するコマンド
2. continue (処理継続) または break (処理終了)
}

204. continue・・・エラーの発生した次の行から処理を継続する
break・・・・エラーの発生した行でスクリプトを終了する
※省略した場合は $ErrorActionPreference の値に従う。

205. ※ Trapは、$ErrorActionPreference = “stop” が指定されている場合、
または 実行したコマンドレットに -ea = “stop”
が指定されている場合の
エラー発生時のみ動作する。

206. ※ 続き
trap文で break または continue を指定しない場合、下記のようになる
• $ErrorActionPreference = “stop” で、コマンドレットの実行エラーが
発生したとき
⇨ trap文が実行され、そのままスクリプト終了
• $ErrorActionPreference = “continue”(デフォルトのまま)で、コマンド
レットのオプションに”-ea stop”を指定し、実行エラーが発生した時
⇨ trap文が実行され、エラーの発生した次の行から処理継続

207. • $Error
• エラー発生時の出力を保存している特殊変数(読み取り専用)

208. • trap ステートメント内で、$Error をログファイルに出力
trap { $Error >> c:¥err.log }
※上記はコマンドの出力をリダイレクトするのと等しい。
dir -ea stop 1>>c:¥err.log 2>&1

209. • trap ステートメント内で、日付時刻と $Error の内容をログファイルに
出力し、スクリプトを終了する例
trap {
get-date >> c:¥err.log
$Error >> c:¥err.log
break
}

210. 2. スクリプトの中で実行する特定のコマンドについ
て、途中でエラーが発生した場合に検知し、何か
コマンドを実行してから終了する
(try~catch~finally)

211. try {
エラー発生の可能性があるコマンド -ea “stop”
} catch [エラーの型] {
エラー発生時に実行するコマンド
return または exit (処理終了する場合)
}
finally {
# エラー発生有無に関わらず最後に実行するコマンド
}
※[エラーの型]は省略可能。
省略した場合、すべてのエラーがcatchされる(Exceptionクラス)

212. Exit・・・・・引数を返してスクリプトを終了する
Return・・・・引数を返して関数を終了する
※省略した場合は $ErrorActionPreference の値に関わらず、処
理を継続する。
tryで失敗してcatchに入り、finallyを実行した後、finallyブロックの
次の行にいく。
(tryブロック中でcatchされたコマンドの以降の行がスキップされる
)

213. • 発生したエラーの型を調べる方法
$error.exception.gettype().fullname
• 例：Copy-Item でコピー元ファイルがない時のエラー型
System.Management.Automation.ItemNotFoundException
• 例：Copy-Item でコピー先フォルダがない時のエラー型
System.IO.IOException

214. • エラー型ごとに複数のcatchを作る例（catchは複数可能）

215. ⇨ 複数catchのうちの１つの[エラー型]に”exception”を指定すると、
全て”exception”のcatchに入ってしまう。

216. ⇨ Powershellスクリプトにおいて、.Netのエラー型での処理分岐は
あまり現実的ではない。
[エラー型]に”exception”を記載するか、記載自体を省略し、全てのエ
ラーをcatchするのが良いと考える。
実行エラーが発生する可能性のあるコマンドが利用するフォルダの
存在確認などは、Test-Pathコマンドなど、確認用のコマンドが用意
されている。事前に実行して、switch文などでブール値判定しておく
。

217. tryに一連の処理を記述し、エラーがあればcatchしてログ出力する例

218. •補足
• trap文とtry~catch文では、try~catch文が優先される。(try~catch文でcatchしたエラ
ーはtrapには掛からない)
• try~catch文のfinallyブロックは省略できる
• trap自体はスクリプト文中のどこに記載しても同じように動作する。(先頭でも最後
尾でも同じ動き)
• エラー処理についてはインターネットにあまり情報がない。(本資料が役に立つこ
とを祈る。)

219. • 終了系コマンドまとめ
Exit・・・・・引数を返してスクリプトを終了する
Return・・・・引数を返して関数を終了する
Break・・・・switch文の中：switch文を抜ける
while文の中 ：while文を抜ける
trap文の中 ：スクリプトを終了する
Continue・・・trap文の中 ：スクリプトを継続する

220. • 関数定義
• 引数なし
function 関数名 {
コマンド
}
• 引数あり
function 関数名 (引数) {
コマンド
}

221. # 例１：関数
function hello-yamazoon ($first,$last) {
“Hello ${last} ${first} !! Welcome to Yamazoon !!”
}
# 関数実行
hello-yamazoon “Yamamoto” “Tetsuya”
⇨ Hello Tetsuya Yamamoto !! Welcome to Yamazoon !!

222. # 例２：begin process end 関数
function count-value {
begin {
$count = 0
}
process {
$count++
echo “$count 回目の値 ： ${_}”
}
end {
echo “数え終わりました。”
}
}

223. # 実行
1,1,2,3,5,8,13 |count-value
# 結果
1 回目の値 ： 1
2 回目の値 ： 1
3 回目の値 ： 2
4 回目の値 ： 3
5 回目の値 ： 5
6 回目の値 ： 8
7 回目の値 ： 13
数え終わりました。