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 对象,该对象表示临时文件。