Add New-TemporaryDirectory cmdlet - #27549
#27549Open
KirtiRamchandani wants to merge 8 commits into
PowerShell:masterPowerShell/PowerShell:masterfrom
KirtiRamchandani:feat/new-temporary-directoryKirtiRamchandani/Powershell:feat/new-temporary-directoryCopy head branch name to clipboard
Open
Add New-TemporaryDirectory cmdlet#27549KirtiRamchandani wants to merge 8 commits intoPowerShell:masterPowerShell/PowerShell:masterfrom KirtiRamchandani:feat/new-temporary-directoryKirtiRamchandani/Powershell:feat/new-temporary-directoryCopy head branch name to clipboard
KirtiRamchandani wants to merge 8 commits into
PowerShell:masterPowerShell/PowerShell:masterfrom
KirtiRamchandani:feat/new-temporary-directoryKirtiRamchandani/Powershell:feat/new-temporary-directoryCopy head branch name to clipboard
Conversation
Contributor
There was a problem hiding this comment.
Pull request overview
Note
Copilot was unable to run its full agentic suite in this review.
Adds the new New-TemporaryDirectory cmdlet to PowerShell Utility, wires it into module exports/default command verification, and introduces Pester coverage + documentation status update.
Changes:
- Adds
New-TemporaryDirectorycmdlet implementation (NewTemporaryDirectoryCommand.cs). - Exports the cmdlet from
Microsoft.PowerShell.Utility(Windows/Unix manifests) and registers it in default-command verification. - Adds Pester tests for the cmdlet and updates the cmdlet test-status documentation table.
Reviewed changes
Copilot reviewed 6 out of 6 changed files in this pull request and generated 3 comments.
Show a summary per file
| File | Description |
|---|---|
| test/powershell/engine/Basic/DefaultCommands.Tests.ps1 | Adds New-TemporaryDirectory to the default cmdlet/alias verification matrix. |
| test/powershell/Modules/Microsoft.PowerShell.Utility/New-TemporaryDirectory.Tests.ps1 | Introduces Pester coverage for creation/uniqueness/WhatIf/output type. |
| src/Modules/Windows/Microsoft.PowerShell.Utility/Microsoft.PowerShell.Utility.psd1 | Exports New-TemporaryDirectory on Windows. |
| src/Modules/Unix/Microsoft.PowerShell.Utility/Microsoft.PowerShell.Utility.psd1 | Exports New-TemporaryDirectory on Unix. |
| src/Microsoft.PowerShell.Commands.Utility/commands/utility/NewTemporaryDirectoryCommand.cs | Implements the cmdlet with SupportsShouldProcess and error handling. |
| docs/testing-guidelines/PowerShellCoreTestStatus.md | Marks New-TemporaryDirectory as delivered/tested in the status table. |
Comment on lines
+44
to
+46
| It "has an OutputType of System.IO.DirectoryInfo" { | ||
| (Get-Command New-TemporaryDirectory).OutputType | Should -BeExactly "System.IO.DirectoryInfo" | ||
| } |
Comment on lines
+21
to
+22
| string tempPath = Path.GetTempPath(); | ||
| if (ShouldProcess(tempPath)) |
Comment on lines
+29
to
+37
| catch (IOException ioException) | ||
| { | ||
| ThrowTerminatingError( | ||
| new ErrorRecord( | ||
| ioException, | ||
| "NewTemporaryDirectoryWriteError", | ||
| ErrorCategory.WriteError, | ||
| tempPath)); | ||
| } |
Member
|
The @PowerShell/wg-powershell-cmdlets discussed this. There's an existing older PR (#26679) that attempts to resolve the same issue, however, it appears that author has not followed-up on existing feedback, therefore we recommend moving forward with this PR. However, we ask that the |
Expose Directory.CreateTempSubdirectory prefix support and add Pester coverage for custom directory name prefixes.
KirtiRamchandani
force-pushed
the
feat/new-temporary-directory
branch
from
June 17, 2026 17:13
969ef08 to
06d71c7
Compare
kilasuit
approved these changes
Jun 17, 2026
Collaborator
|
@SteveL-MSFT @kilasuit @Thatgfsj |
sdwheeler
suggested changes
Jun 24, 2026
| /// <summary> | ||
| /// The implementation of the "New-TemporaryDirectory" cmdlet. | ||
| /// </summary> | ||
| [Cmdlet(VerbsCommon.New, "TemporaryDirectory", SupportsShouldProcess = true, ConfirmImpact = ConfirmImpact.Low)] |
Collaborator
There was a problem hiding this comment.
Please add this HelpUri
Suggested change
| [Cmdlet(VerbsCommon.New, "TemporaryDirectory", SupportsShouldProcess = true, ConfirmImpact = ConfirmImpact.Low)] | |
| [Cmdlet(VerbsCommon.New, "TemporaryDirectory", SupportsShouldProcess = true, ConfirmImpact = ConfirmImpact.Low, HelpUri = "https://go.microsoft.com/fwlink/?LinkId=2097032")] |
12 tasks
Author
|
@jshigetomi @SteveL-MSFT @sdwheeler Are we good to merge this? |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
PR Summary
Add
New-TemporaryDirectorytoMicrosoft.PowerShell.Utility.The new cmdlet follows the shape of
New-TemporaryFile: it supportsShouldProcess, uses low confirmation impact, exports from the Utility module on Windows and Unix, and returns aSystem.IO.DirectoryInfofor a unique directory under the system temp path.PR Context
Fixes #25754.
The working group recommended adding
New-TemporaryDirectoryso users can create temporary directories without calling[System.IO]directly. That matters in constrained and restricted language modes where direct .NET type access is not available.Validation
git diff --checkSystem.Management.Automation.Language.ParserStart-PSBuild -Clean -PSModuleRestore -UseNuGetOrgStart-PSPester -Path test/powershell/Modules/Microsoft.PowerShell.Utility/New-TemporaryDirectory.Tests.ps1 -Tag CI -SkipTestToolBuild -UseNuGetOrg(4 passed)Start-PSPester -Path test/powershell/engine/Basic/DefaultCommands.Tests.ps1 -Tag CI -UseNuGetOrg(290 passed)New-TemporaryDirectoryreturnsSystem.IO.DirectoryInfo, creates the directory, and places it under[System.IO.Path]::GetTempPath()PR Checklist
masterbranch.