Set-Content

構文

Set-Content
   [-Path] <string[]>
   [-Value] <Object[]>
   [-PassThru]
   [-Filter <string>]
   [-Include <string[]>]
   [-Exclude <string[]>]
   [-Force]
   [-Credential <pscredential>]
   [-WhatIf]
   [-Confirm]
   [-UseTransaction]
   [-NoNewline]
   [-Encoding <FileSystemCmdletProviderEncoding>]
   [-Stream <string>]
   [<CommonParameters>]

Set-Content
   [-Value] <Object[]>
   -LiteralPath <string[]>
   [-PassThru]
   [-Filter <string>]
   [-Include <string[]>]
   [-Exclude <string[]>]
   [-Force]
   [-Credential <pscredential>]
   [-WhatIf]
   [-Confirm]
   [-UseTransaction]
   [-NoNewline]
   [-Encoding <FileSystemCmdletProviderEncoding>]
   [-Stream <string>]
   [<CommonParameters>]

Set-Content
   [-Path] <string[]>
   [-Value] <Object[]>
   [-PassThru]
   [-Filter <string>]
   [-Include <string[]>]
   [-Exclude <string[]>]
   [-Force]
   [-Credential <pscredential>]
   [-WhatIf]
   [-Confirm]
   [-UseTransaction]
   [<CommonParameters>]

Set-Content
   [-Value] <Object[]>
   -LiteralPath <string[]>
   [-PassThru]
   [-Filter <string>]
   [-Include <string[]>]
   [-Exclude <string[]>]
   [-Force]
   [-Credential <pscredential>]
   [-WhatIf]
   [-Confirm]
   [-UseTransaction]
   [<CommonParameters>]

説明

Set-Content は、新しいコンテンツを書き込むか、ファイル内のコンテンツを置き換える文字列処理コマンドレットです。 Set-Content は既存のコンテンツを置き換え、ファイルにコンテンツを追加する Add-Content コマンドレットとは異なります。 Set-Contentにコンテンツを送信するには、コマンド ラインで Value パラメーターを使用するか、パイプライン経由でコンテンツを送信します。

次の例でファイルまたはディレクトリを作成する必要がある場合は、「 New-Itemを参照してください。

例

例 1: ディレクトリ内の複数のファイルの内容を置き換える

次の使用例は、現在のディレクトリ内の複数のファイルの内容を置き換えます。

Get-ChildItem -Path .\Test*.txt

Test1.txt
Test2.txt
Test3.txt

Set-Content -Path .\Test*.txt -Value 'Hello, World'
Get-Content -Path .\Test*.txt

Hello, World
Hello, World
Hello, World

Get-ChildItem コマンドレットは、Path パラメーターを使用して、現在のディレクトリのTest*で始まる.txtファイルを一覧表示します。 Set-Content コマンドレットは、Path パラメーターを使用してTest*.txt ファイルを指定します。 Value パラメーターは、各ファイル内の既存のコンテンツを置き換えるテキスト文字列 Hello, World を提供します。 Get-Content コマンドレットは、Path パラメーターを使用してTest*.txt ファイルを指定し、PowerShell コンソールに各ファイルの内容を表示します。

例 2: 新しいファイルを作成してコンテンツを書き込む

次の使用例は、新しいファイルを作成し、現在の日時をファイルに書き込みます。

Set-Content -Path .\DateTime.txt -Value (Get-Date)
Get-Content -Path .\DateTime.txt

1/30/2019 09:55:08

Set-Content は、 Path パラメーターと Value パラメーターを使用して、現在のディレクトリに DateTime.txt という名前の新しいファイルを作成します。 Value パラメーターはGet-Dateを使用して現在の日付と時刻を取得します。 Set-ContentDateTime オブジェクトを文字列としてファイルに書き込みます。 Get-Content コマンドレットは、Path パラメーターを使用して、PowerShell コンソールにDateTime.txtの内容を表示します。

例 3: ファイル内のテキストを置き換える

このコマンドは、既存のファイル内の単語のすべてのインスタンスを置き換えます。

Get-Content -Path .\Notice.txt

Warning
Replace Warning with a new word.
The word Warning was replaced.

(Get-Content -Path .\Notice.txt) |
    ForEach-Object {$_ -Replace 'Warning', 'Caution'} |
        Set-Content -Path .\Notice.txt
Get-Content -Path .\Notice.txt

Caution
Replace Caution with a new word.
The word Caution was replaced.

Get-Content コマンドレットは、Path パラメーターを使用して、現在のディレクトリ内のNotice.txt ファイルを指定します。 Get-Content コマンドはかっこで囲まれ、パイプラインに送信される前にコマンドが終了します。

Notice.txt ファイルの内容は、パイプラインから ForEach-Object コマンドレットに送信されます。 ForEach-Object は自動変数 $_ を使用し、 Warning の各出現箇所を Caution に置き換えます。 オブジェクトは、パイプラインから Set-Content コマンドレットに送信されます。 Set-Content では、 Path パラメーターを使用して Notice.txt ファイルを指定し、更新されたコンテンツをファイルに書き込みます。

最後の Get-Content コマンドレットは、更新されたファイルの内容を PowerShell コンソールに表示します。

例 4: Set-Content でフィルターを使用する

Set-Content コマンドレットにフィルターを指定できます。 フィルターを使用して Path パラメーターを修飾する場合は、パスの内容を示す末尾のアスタリスク (*) を含める必要があります。

次のコマンドは、C:\Temp ディレクトリ内のすべての*.txt ファイルの内容を Value 空に設定します。

Set-Content -Path C:\Temp\* -Filter *.txt -Value "Empty"

パラメーター

-Confirm

-Credential

-Encoding

-Exclude

-Filter

-Force

-Include

-LiteralPath

-NoNewline

-PassThru

-Path

-Stream

-UseTransaction

-Value

-WhatIf

入力

Object

項目の新しい値を含むオブジェクトをこのコマンドレットにパイプできます。

出力

None

既定では、このコマンドレットは出力を返しません。

String

PassThru パラメーターを使用すると、このコマンドレットはコンテンツを表す文字列を返します。

メモ

Windows PowerShell には、 Set-Contentの次のエイリアスが含まれています。

• sc

• Set-Content は文字列処理用に設計されています。 文字列以外のオブジェクトをパイプして Set-Contentすると、オブジェクトを書き込む前に文字列に変換されます。 オブジェクトをファイルに書き込むには、 Out-Fileを使用します。

• Set-Content コマンドレットは、任意のプロバイダーによって公開されるデータを操作するように設計されています。 セッションで使用可能なプロバイダーを一覧表示するには、「 Get-PsProvider」と入力します。 詳細については、「 about_Providers」を参照してください。

関連リンク

• about_Aliases
• about_Automatic_Variables.md
• about_Providers
• about_Transactions
• Add-Content
• Clear-Content
• Get-ChildItem
• Get-Content
• ForEach-Object
• New-Item