構文

Add-Content <string> <Object> >] >] 

Add-Content <Object> -LiteralPath <string> >] >] 

説明

Add-Contentコマンドレットは、指定された項目またはファイルにコンテン コンテンツを指定するには、コマンドでコンテンツを入力するか、コンテンツを含むオブジェクトを指定します。次の例でファイルまたはディレクトリを作成する必要がある場合は、New-Itemを参照してください。

例

例1:例外を除いてすべてのテキストファイルに文字列を追加する

この例では、現在のディレクトリ内のテキストファイルに値を追加しますが、そのファイル名に基づいてファイルを除外します。P>

Add-Content -Path .\*.txt -Exclude help* -Value 'End of file'

Pathパラメーターは、現在のディレクトリ内のすべての.txtファイルを指定しますが、Excludeparameterは指定されたパターンに一致するファイ Valueパラメーターは、ファイルに書き込まれるテキスト文字列を指定します。

例2: 指定されたファイルの末尾に日付を追加する

この例では、現在のディレクトリ内のファイルに日付を追加し、powershellコンソールに日付を表示します。

Add-Content -Path .\DateTimeFile1.log, .\DateTimeFile2.log -Value (Get-Date) -PassThruGet-Content -Path .\DateTimeFile1.logTuesday, May 14, 2019 8:24:27 AMTuesday, May 14, 2019 8:24:27 AM5/14/2019 8:24:27 AM

Add-Contentコマンドレットは、現在のディレクトリに二つの新しいファイルを作成します。 Valueパラメーターには、Get-Dateコマンドレットの出力が含まれます。 PassThruパラメーターは、追加された内容をパイプラインに出力します。出力を受信するコマンドレットは他にないため、PowerShellコンソールに表示されます。Get-ContentDateTimeFile1.logを表示します。

例3:指定したファイルの内容を別のファイルに追加する

この例では、ファイルから内容を取得し、その内容を変数に格納します。 変数は、コンテンツを別のファイルに追加するために使用されます。

$From = Get-Content -Path .\CopyFromFile.txtAdd-Content -Path .\CopyToFile.txt -Value $FromGet-Content -Path .\CopyToFile.txt

• Get-ContentCopyFromFile.txt$From変数に格納します。
• Add-ContentCopyToFile.txt$From変数の内容を使用して更新します。
• Get-ContentコマンドレットはCopyToFileを表示します。txt。

例4:パイプラインを使用して、指定したファイルの内容を別のファイルに追加します

この例では、ファイルから内容を取得し、それをAdd-Content

Get-Content -Path .\CopyFromFile.txt | Add-Content -Path .\CopyToFile.txtGet-Content -Path .\CopyToFile.txt

Get-ContentCopyFromFile.txtAdd-ContentCopyToFile.txtGet-ContentCopyToFile.txtを表示します。

例5:新しいファイルを作成して内容をコピーする

この例では、新しいファイルを作成し、既存のファイルの内容を新しいファイルにコピーし

Add-Content -Path .\NewFile.txt -Value (Get-Content -Path .\CopyFromFile.txt)Get-Content -Path .\NewFile.txt

• Add-Contentコマンドレットは、パスと値のパラメーターを使用して、現在のディレクトリに新しいファイルを作成します。
• Get-ContentCopyFromFile.txtの内容を取得し、それをValueパラメーターに渡します。 Get-ContentAdd-Contentコマンドが開始される前にコマンドが終了することを保証します。
• Get-ContentNewFile.txtの内容を表示します。

例6:読み取り専用ファイルにコンテンツを追加

このコマンドは、IsReadOnly file属性がTrueに設定されている場合でも、ファイルに値を追加します。この例には、読み取り専用ファイルを作成する手順が含まれています。

New-Item -Path .\IsReadOnlyTextFile.txt -ItemType FileSet-ItemProperty -Path .\IsReadOnlyTextFile.txt -Name IsReadOnly -Value $TrueGet-ChildItem -Path .\IsReadOnlyTextFile.txtAdd-Content -Path .\IsReadOnlyTextFile.txt -Value 'Add value to read-only text file' -ForceGet-Content -Path .\IsReadOnlyTextFile.txtMode LastWriteTime Length Name---- ------------- ------ -----ar-- 1/28/2019 13:35 0 IsReadOnlyTextFile.txt

• New-Itemコマンドレットは、PathパラメーターとItemTypeパラメーターを使用して、現在のディレクトリにファイルIsReadOnlyTextFile.txtを作成します。
• Set-ItemPropertyコマンドレットは、NameパラメーターとValueパラメーターを使用して、fileのisreadonlyプロパティをTrueに変更します。
• Get-ChildItemr）を持っていることを示しています。
• Add-Contentコマンドレットは、Pathパラメーターを使用してファイルを指定します。 値parameterincludesには、ファイルに追加するテキスト文字列が含まれます。 Forceパラメーターは、テキストを読み取り専用のファイルに書き込みます。
• Get-Contentコマンドレットは、Pathパラメーターを使用してファイルの内容を表示します。読み取り専用属性を削除するには、値parametersetをFalseSet-ItemPropertyコマンドを使用します。

  例7:Add-Contentでフィルターを使用する

  Add-Contentコマンドレットにフィルターを指定できます。 フィルタを使用してPathparameterを修飾する場合は、パスの内容を示すために末尾のアスタリスク（*C:\Temp*.txtファイルの内容を”Done”という単語を追加します。

  Add-Content -Path C:\Temp\* -Filter *.txt -Value "Done"

  パラメータ

  -AsByteStream

  コンテンツをバイトのストリームとして読み取る必要があることを指定します。 このパラメータはPowerShell6.0で導入されました。

  Encodingパラメーターを指定してAsByteStreamパラメーターを使用すると、警告が発生します。 TheAsByteStream parameter ignores any encoding and the output is returned as a stream of bytes.

  Type:	SwitchParameter
  Position:	Named
  Default value:	None
  Accept pipeline input:	False
  Accept wildcard characters:	False

  -Confirm

  Prompts you for confirmation before running the cmdlet.

  Type:
  パイプライン入力を受け入れる:	False
  パイプライン入力を受け入れる:	False
  パイプライン入力を受け入れる:	False
  パイプライン入力を受け入れる:	False
  パイプライン入力を受け入れる:	False
  パイプライン入力を受け入れる:	False
  パイプライン入力を受け入れる:	False
  パイプライン入力を受け入れる:
  パイプライン入力を受け入れる:
  パイプライン入力を受け入れる:
  パイプライン入力を受け入れる:ワイルドカード文字:	False

  -credential

  注

  このパラメータは、インストールされているプロバイダではサポートされていませんPowerShell.To 別のユーザーを偽装するか、このコマンドレットを実行するときに資格情報を昇格するには、Invoke-Commandを使用します。

  Type:	PSCredential
  Position:	Named
  Default value:	None
  Accept pipeline input:	True
  Accept wildcard characters:	False

  -Encoding

  Specifies the type of encoding for the target file. The default value is utf8NoBOM.

  Encoding is a dynamic parameter that the FileSystem provider adds to the Add-Content cmdlet. Thisparameterはファイルシステムドライブでのみ動作します。

  このパラメータに使用できる値は次のとおりです。

  • ascii:ASCII(7ビット)文字セットのエンコーディングを使用します。
  • bigendianunicode:ビッグエンディアンバイトオーダーを使用してUTF-16形式でエンコードします。
  • bigendianutf32:ビッグエンディアンバイトオーダーを使用してUTF-32形式でエンコードします。
  • oem:MS-DOSおよびコンソールプログラムのデフォルトのエンコーディングを使用します。
  • unicode
  • unicode

  : リトルエンディアンのバイト順を使用してUTF-16形式でエンコードします。

• utf7:UTF-7形式でエンコードします。
• utf8:UTF-8形式でエンコードします。
• utf8BOM:バイト順マーク(BOM)付きのUTF-8形式でエンコード
• utf8NoBOM:バイト順マーク(BOM)なしのUTF-8形式でエンコード
• utf32:UTF-32形式でエンコードします。

PowerShell6から始まります。2、Encodingパラメータは、登録されたコードページの数値Id(-Encoding 1251-Encoding "windows-1251"のような)も許可します。 詳細については、.netのドキュメントforEncodingを参照してください。コードページ。注意:UTF-7*の使用は推奨されなくなりました。 PowerShell7.1では、エンコーディングパラメータにutf7を指定すると、警告が書き込まれます。Tr>

ASCII, BigEndianUnicode, BigEndianUTF32, OEM, Unicode, UTF7, UTF8, UTF8BOM, UTF8NoBOM, UTF32

Position: Named Default value: UTF8NoBOM Accept pipeline input: False Accept wildcard characters: False