New-TemporaryFile

创建临时文件。

语法

Default (默认值)

New-TemporaryFile
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

说明

此 cmdlet 创建可在脚本中使用的临时文件。

New-TemporaryFile cmdlet 创建一个扩展名为 .tmp 的空文件。 此 cmdlet 将文件命名为 tmp<NNNN>.tmp,其中 <NNNN> 是随机十六进制数。 此 cmdlet 会在 TEMP 文件夹中创建文件。

此 cmdlet 使用 Path.GetTempPath() 方法查找 TEMP 文件夹。 此方法按以下顺序检查环境变量是否存在,并使用找到的第一个路径:

  • 在 Windows 平台上:

    1. TMP 环境变量指定的路径。
    2. TEMP 环境变量指定的路径。
    3. USERPROFILE 环境变量指定的路径。
    4. Windows 目录。
  • 在非 Windows 平台上:使用 TMPDIR 环境变量指定的路径。

示例

示例 1:创建临时文件

$TempFile = New-TemporaryFile

此命令在临时文件夹中生成 .tmp 文件,然后将对文件的引用存储在 $TempFile 变量中。 稍后可以在脚本中使用此文件。

参数

-Confirm

在运行 cmdlet 之前,提示你进行确认。

参数属性

类型:SwitchParameter
默认值:False
支持通配符:False
不显示:False
别名:cf

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-WhatIf

显示 cmdlet 运行时会发生什么情况。 命令脚本未运行。

参数属性

类型:SwitchParameter
默认值:False
支持通配符:False
不显示:False
别名:无线

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

CommonParameters

此 cmdlet 支持通用参数:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息,请参阅 about_CommonParameters

输出

FileInfo

此 cmdlet 返回表示临时文件的 FileInfo 对象。