(AB-538640) Clarify behavior of Rename-Item when new name item exists#12915
Conversation
This comment was marked as outdated.
This comment was marked as outdated.
This comment was marked as outdated.
This comment was marked as outdated.
There was a problem hiding this comment.
Pull request overview
Updates Rename-Item reference docs to clarify that renaming to an already-existing name does not replace the destination item, including when -Force is used.
Changes:
- Add narrative guidance that
Rename-Itemcannot replace an existing destination name and suggestMove-Item -Forceinstead. - Clarify
-Forceparameter behavior to explicitly note it doesn’t replace an existing item named by-NewName. - Refresh
ms.datemetadata across supported versioned references.
Reviewed changes
Copilot reviewed 4 out of 4 changed files in this pull request and generated 2 comments.
| File | Description |
|---|---|
| reference/7.6/Microsoft.PowerShell.Management/Rename-Item.md | Adds/clarifies guidance around non-overwriting rename behavior and updates metadata date. |
| reference/7.5/Microsoft.PowerShell.Management/Rename-Item.md | Same clarification for 7.5 docs plus metadata date update. |
| reference/7.4/Microsoft.PowerShell.Management/Rename-Item.md | Same clarification for 7.4 docs plus metadata date update. |
| reference/5.1/Microsoft.PowerShell.Management/Rename-Item.md | Same clarification for Windows PowerShell 5.1 docs plus metadata date update. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
292e26a to
83e64a3
Compare
PoliCheck Scan ReportThe following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 and severity-2 issues. The AI Review Details column lists suggestions for either removing or replacing the terms. If you find a false positive result, mention it in a PR comment and include this text: #policheck-false-positive. This feedback helps reduce false positives in future scans. ✅ No issues foundMore information about PoliCheckInformation: PoliCheck | Severity Guidance | Term |
|
Learn Build status updates of commit 83e64a3: ✅ Validation status: passed
For more details, please refer to the build report. |
PR Summary
This change fixes AB#538640 by clarifying the behavior of
Rename-Itemwhen the new name for the item already exists and thatRename-Item -Forcedoesn't replace the existing item.PR Checklist