Writing files (Set-Content, Out-File) in PowerShell

Introduction

Writing files lets you save information from your script to your computer. This helps keep data for later use or sharing.

Save a list of names or data from a script to a text file.

Create a log file to track what your script does.

Export results from a command to share with others.

Save configuration settings from a script.

Write output from a script to a file for backup.

Syntax

PowerShell

Set-Content -Path <file-path> -Value <content>
Out-File -FilePath <file-path> [-Encoding <encoding>] [-Append]

Set-Content replaces the file content or creates a new file.

Out-File sends output to a file and can append or overwrite.

Examples

This writes "Hello World" to example.txt, replacing any existing content.

PowerShell

Set-Content -Path "C:\temp\example.txt" -Value "Hello World"

This writes "Hello again" to example.txt with UTF8 encoding.

PowerShell

Out-File -FilePath "C:\temp\example.txt" -InputObject "Hello again" -Encoding UTF8

This adds "More text" to the end of example.txt without removing existing content.

PowerShell

Out-File -FilePath "C:\temp\example.txt" -InputObject "More text" -Append

Sample Program

This script writes "First line" to output.txt, then adds "Second line" below it. Finally, it reads and shows the file content.

PowerShell

Set-Content -Path "output.txt" -Value "First line"
Out-File -FilePath "output.txt" -InputObject "Second line" -Append
Get-Content -Path "output.txt"

Important Notes

Use Set-Content when you want to replace the whole file content.

Use Out-File with -Append to add to existing files.

Check file paths carefully to avoid overwriting important files.

Summary

Set-Content writes or replaces file content.

Out-File sends output to a file and can append.

Use these commands to save script results or logs easily.

Practice

1. What does the PowerShell command Set-Content do when used on a file?

easy

A. It writes new content to the file, replacing any existing content.

B. It appends new content to the end of the file without removing existing content.

C. It deletes the file from the system.

D. It reads the content of the file and displays it on the screen.

Solution

1. Step 1: Understand Set-Content behavior

   Set-Content writes data to a file and replaces any existing content by default.

2. Step 2: Compare with other commands

   Unlike Out-File with -Append, Set-Content does not append but overwrites.

3. Final Answer:

   It writes new content to the file, replacing any existing content. -> Option A

4. Quick Check:

   Set-Content replaces file content = D [OK]

Hint: Set-Content replaces file content, Out-File can append [OK]

Common Mistakes:

• Confusing Set-Content with appending behavior
• Thinking Set-Content reads files
• Assuming it deletes files

2. Which of the following is the correct syntax to append text to a file using Out-File?

easy

A. Out-File -FilePath "log.txt" -InputObject "New entry" -Append

B. Out-File -FilePath "log.txt" -InputObject "New entry"

C. Set-Content -Path "log.txt" -Value "New entry" -Append

D. Set-Content -FilePath "log.txt" -InputObject "New entry"

Solution

1. Step 1: Identify append syntax for Out-File

   Out-File uses the -Append parameter to add content without overwriting.

2. Step 2: Check other options

   Set-Content does not support -Append; Out-File -FilePath "log.txt" -InputObject "New entry" -Append correctly uses Out-File with -Append.

3. Final Answer:

   Out-File -FilePath "log.txt" -InputObject "New entry" -Append -> Option A

4. Quick Check:

   Out-File append needs -Append flag = A [OK]

Hint: Use -Append with Out-File to add content, not Set-Content [OK]

Common Mistakes:

• Using -Append with Set-Content (unsupported)
• Omitting -Append when appending with Out-File
• Mixing parameter names like -Value and -InputObject

3. What will be the content of the file output.txt after running this script?

"Line1" | Set-Content output.txt
"Line2" | Out-File output.txt -Append
"Line3" | Set-Content output.txt

medium

A. Line1\nLine2\nLine3

B. Line3

C. Line1\nLine2

D. Line1

Solution

1. Step 1: Analyze first command

   Set-Content writes "Line1" to output.txt, replacing any existing content.

2. Step 2: Analyze second command

   Out-File with -Append adds "Line2" after "Line1" in output.txt.

3. Step 3: Analyze third command

   Set-Content overwrites the entire file with "Line3", removing previous lines.

4. Final Answer:

   Line3 -> Option B

5. Quick Check:

   Last Set-Content overwrites file = B [OK]

Hint: Last Set-Content overwrites file, ignoring previous appends [OK]

Common Mistakes:

• Assuming appends persist after Set-Content
• Confusing Out-File and Set-Content effects
• Thinking all lines accumulate

4. You want to append the text "Error found" to a log file using Set-Content, but your script overwrites the file instead. What is the mistake?

medium

A. You need to use the -Force parameter with Set-Content to append.

B. You forgot to use the -Append parameter with Set-Content.

C. Set-Content does not support appending; use Out-File with -Append instead.

D. You should use Get-Content before Set-Content to append.

Solution

1. Step 1: Understand Set-Content capabilities

   Set-Content replaces file content and does not have an append option.

2. Step 2: Identify correct command for appending

   Out-File supports appending with the -Append parameter, which is the proper choice.

3. Final Answer:

   Set-Content does not support appending; use Out-File with -Append instead. -> Option C

4. Quick Check:

   Set-Content cannot append = C [OK]

Hint: Set-Content overwrites; use Out-File -Append to add text [OK]

Common Mistakes:

• Trying to use -Append with Set-Content
• Assuming -Force enables appending
• Using Get-Content unnecessarily

5. You have a script that generates multiple lines of output stored in a variable $results (an array of strings). You want to save all lines to a file named "report.txt" without overwriting existing content. Which approach correctly appends all lines?

hard

A. Write-Output $results > "report.txt"

B. $results | Out-File -FilePath "report.txt"

C. $results | Set-Content -Path "report.txt"

D. Add-Content -Path "report.txt" -Value $results

Solution

1. Step 1: Understand appending multiple lines

   Add-Content appends content to a file and accepts arrays to write multiple lines.

2. Step 2: Compare other options

   Set-Content overwrites; Out-File without -Append overwrites; Write-Output with > overwrites.

3. Final Answer:

   Add-Content -Path "report.txt" -Value $results -> Option D

4. Quick Check:

   Add-Content appends arrays correctly = A [OK]

Hint: Use Add-Content to append arrays of lines easily [OK]

Common Mistakes:

• Using Set-Content which overwrites
• Using > redirection which overwrites
• Not using -Append with Out-File