New-TemporaryFile

模組:
Microsoft.PowerShell.Utility Module

建立一個暫存檔案。

語法

Default (預設值) 

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

Description

這個 cmdlet 會建立你可以在腳本中使用的暫存檔案。

這個指令子會New-TemporaryFile建立一個空檔，副檔名為.tmp 此指令檔命名 tmp<NNNN>.tmp為 ，其中 <NNNN> 是隨機十六進位數。 指令長會建立檔案到你的 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
別名:參見

參數集

(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 物件。