HOME > Content系コマンドレット > Add-Content
Add-Content
Add-Contentは、コンテントを追加するコマンドです。
エイリアスac
解説
既存ファイルに内容を追記します。
指定したファイルが存在しない場合は、新規にファイルを作成した上で書き込みます。
構文
- （構文）
- Add-Content [-Path] <string[]> [-Value] <Object[]> [<CommonParameters>] Add-Content [-Value] <Object[]> [<CommonParameters>]
| パラメータ | 説明 |
|---|---|
| -Value 値 | 値を指定する |
| -PathThru | 通常は出力しない値を出力るようにする |
| -Path パス | 対象パスを指定する（ワイルドカード使用可） （例）-Path "D:\test*" |
| -LiteralPath パス | 対象パスを指定する（ワイルドカード使用不可） （例）-LiteralPath "D:\test" |
| -Filter フィルター | Pathパラメーターを修飾するフィルターを指定する |
| -Include 文字列 | 指定した文字列を対象に含める （ワイルドカード使用可） （例）-Include *.log,*.tmp ⇒拡張子がlog、tmpのファイルを含める |
| -Exclude 文字列 | 指定した文字列を対象から除外する （ワイルドカード使用可） （例）-Exclude Test* ⇒ファイルがTestで始まる物を除外する |
| -Force | 強制的に実行する |
| -Credential 資格情報 | 資格情報を指定する |
| -WhatIf | 実行はせずに実行結果の確認のみ行う |
| -Confirm | 実行前に確認メッセージの表示を行う |
| -UseTransaction | トランザクションに参加する |
| -NoNewline | 最後に改行コードを入れない |
| -Encoding 文字コード | 文字コードを指定する |
| -Stream ストリーム名 | ストリーム名を指定する ※Windowsのみ使用可。 |
共通的なパラメータは「共通パラメータ」をご覧ください。
サンプル
既存ファイルsample.txtに"あいう"を追記する
Add-Content -Path sample.txt -Value "あいう"
コマンドのヘルプを表示する
Get-Help Add-Content
備考
- パラメータ名の「-Path」は省略可能です。
- 既存ファイルを上書きしたい場合はSet-Contentsコマンドをご使用ください。
関連項目
- Content系コマンドレット
- Get-Content：コンテントを取得する
- Set-Content：コンテントを設定する
- Add-Content：コンテントを追加する
- Clear-Content：コンテントをクリアする
