New-TemporaryFile

  • リファレンス
モジュール:
Microsoft.PowerShell.Utility

一時ファイルを作成します。

構文

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

説明

このコマンドレットは、スクリプトで使用できる一時ファイルを作成します。

このコマンドレットは New-TemporaryFile 、ファイル名拡張子を持つ空のファイルを .tmp 作成します。 このコマンドレットは、ファイル tmp<NNNN>.tmpにランダム <NNNN> な 16 進数の名前を付けます。 このコマンドレットは、TEMP フォルダーにファイルを作成します。

このコマンドレットでは、Path.GetTempPath() メソッドを使用して TEMP フォルダーを検索します。 このメソッドは、環境変数の存在を次の順序でチェックし、最初に見つかったパスを使用します。

  • Windows プラットフォームの場合:

    1. TMP 環境変数で指定されたパス。
    2. TEMP 環境変数で指定されたパス。
    3. USERPROFILE 環境変数で指定されたパス。
    4. Windows ディレクトリ。

  • Windows 以外のプラットフォームの場合: TMPDIR 環境変数で指定されたパスを使用します。

例

例 1: 一時ファイルを作成する

$TempFile = New-TemporaryFile

このコマンドは、 .tmp 一時フォルダーにファイルを生成し、そのファイルへの参照を変数に $TempFile 格納します。 このファイルは、後でスクリプトで使用できます。

パラメーター

-Confirm

コマンドレットの実行前に確認を求めるメッセージが表示されます。

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

出力

FileInfo

このコマンドレットは、一時ファイルを 表す FileInfo オブジェクトを返します。