もくじ
📝 はじめに
PowerShellを使って作業をしていると、
「空のファイルを作成したい」
「設定ファイルやログファイルのひな形を用意したい」
「スクリプト内でファイルが存在しなければ作りたい」
という場面はよくあります。
そんなときに使うのが
New-Item -ItemType File です。
PowerShellで空のファイルを新規作成できる、基本かつ重要な操作です。
- 空のファイルを作成したい
- 設定ファイルのひな形を用意したい
- スクリプトで必要なファイルを自動生成したい
✅ この操作でできること(要点)
- 空のファイルを新規作成できる
- 既存ファイルがある場合はエラーになる
- -Force を使えば柔軟に制御できる
- スクリプトの初期化処理に向いている
✅ New-Item -ItemType File でできること
New-Item -ItemType File は、
指定したパスに空のファイルを作成するコマンドです。
作成されるファイルには中身はなく、
あくまで「ファイルの器」だけが用意されます。
考え方としては「中身のないノートを1冊用意する」と覚えると分かりやすいでしょう。
🧩 基本構文
New-Item ファイルパス -ItemType File
ファイル名まで含めたパスを指定します。
▶ 基本的な使い方(まずこれだけ)
🔹 空のファイルを作成する
New-Item C:\Work\sample.txt -ItemType File
sample.txt という空ファイルが作成されます。
すでに存在する場合はエラーになります。
🔹 拡張子を自由に指定する
New-Item C:\Work\config.json -ItemType File
拡張子に制限はなく、
任意のファイル形式を作成できます。
🛠 よく使われる指定例
🔹 すでに存在してもエラーにしない
New-Item C:\Work\sample.txt -ItemType File -Force
ファイルが存在していてもエラーにならず、
そのまま処理を続行できます。
🔹 親フォルダがなくても作成
New-Item C:\Work\Data\log.txt -ItemType File -Force
親フォルダが存在しない場合でも、
-Force により一緒に作成されます。
💼 実務でよく使う使用例(応用)
🔹 ファイルがなければ作成する
if (-not (Test-Path C:\Work\settings.ini)) {
New-Item C:\Work\settings.ini -ItemType File
}
🔹 ログファイルの初期化
$log = "C:\Logs\app.log"
New-Item $log -ItemType File -Force
- Test-Path で存在確認
- -Force で安全に作成
- 初期化処理・ログ作成に活用
🧩 よくある勘違い・つまずきポイント
- 作成されるのは空ファイルのみ
- 中身を書き込みたい場合は別コマンドが必要
- 既存ファイルがあるとエラーになる
- -Force を付けると挙動が変わる
- mkdir とは用途が異なる
🔄 cmdとの違いについて
cmd では type nul > file.txt のような書き方をしますが、
PowerShell の New-Item -ItemType File は
意図が分かりやすく、安全に書けます。
⚠ エラー・うまく動かないときの確認ポイント
- 作成先パスが正しいか
- 書き込み権限があるか
- ファイル名・拡張子に誤りがないか
- -Force が必要なケースではないか
🧠 注意点
New-Item -ItemType File は
ファイルを「作るだけ」で中身は書き込みません。
内容を書きたい場合は
Set-Content や
Add-Content と組み合わせましょう。
📌 まとめ
- New-Item -ItemType File で空ファイルを作成できる
- 拡張子は自由に指定できる
- -Force を使うと柔軟に制御できる
- 初期化・ログ作成でよく使われる
🔎 PowerShellコマンドを探す
やりたいことからコマンドを探すこともできます。
- 空のファイルを作成したい
- 設定ファイルを用意したい
- ログファイルを作りたい
- 存在しなければファイルを作成したい
- エラーや実行できない原因を調べたい
- ファイル操作を自動化したい
- 安全に新規作成したい
