Document new `-Extension` parameter for `Join-Path` cmdlet

[yotsuda]

Prerequisites

• Existing Issue: Search the existing issues for this repository. If there is an issue that fits your needs do not file a new one. Subscribe, react, or comment on that issue instead.
• Descriptive Title: Write the title for this issue as a short synopsis. If possible, provide context. For example, "Document new Get-Foo cmdlet" instead of "New cmdlet."

Summary

Added new parameter to Join-Path cmdlet to enable adding, changing, or removing file extensions.
The new parameter -Extension needs to be documented.

Details

Example 1: Add extension to file without extension

Join-Path C:\Temp myfile -Extension txt
# Returns: C:\Temp\myfile.txt

Example 2: Change existing extension

Join-Path C:\Temp myfile.txt -Extension .log
# Returns: C:\Temp\myfile.log

Example 3: Extension without leading dot

Join-Path C:\Temp file.txt -Extension log
# Returns: C:\Temp\file.log

Example 4: Remove extension with empty string

Join-Path C:\Temp file.txt -Extension ""
# Returns: C:\Temp\file

Articles

• reference/7.6/Microsoft.PowerShell.Management/Join-Path.md

Related Source Pull Requests

• Add -Extension parameter to Join-Path cmdlet PowerShell/PowerShell#26482

Related Source Issues

• Join-Path -Extension <string> parameter PowerShell/PowerShell#20724