Udostępnij przez

New-TemporaryFile

Moduł:
Microsoft.PowerShell.Utility Module

Tworzy plik tymczasowy.

Składnia

Default (domyślnie) 

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

Opis

To polecenie cmdlet tworzy pliki tymczasowe, których można używać w skryptach.

Polecenie cmdlet New-TemporaryFile tworzy pusty plik z rozszerzeniem nazwy pliku .tmp. Cmdlet nazywa plik tmp<NNNN>.tmp, gdzie <NNNN> jest losową liczbą szesnastkową. Cmdlet tworzy plik w folderze TEMP.

To polecenie cmdlet używa metody Path.GetTempPath(), aby znaleźć folder TEMP. Ta metoda sprawdza istnienie zmiennych środowiskowych w następującej kolejności i używa pierwszej znalezionej ścieżki:

  • Na platformach windows:

    1. Ścieżka określona przez zmienną środowiskową TMP.
    2. Ścieżka określona przez zmienną środowiskową TEMP.
    3. Ścieżka określona przez zmienną środowiskową USERPROFILE.
    4. Katalog systemu Windows.

  • Na platformach innych niż Windows: używa ścieżki określonej przez zmienną środowiskową TMPDIR.

Przykłady

Przykład 1. Tworzenie pliku tymczasowego

$TempFile = New-TemporaryFile

To polecenie generuje plik .tmp w folderze tymczasowym, a następnie przechowuje odwołanie do pliku w zmiennej $TempFile. Możesz użyć tego pliku w dalszej części skryptu.

Parametry

-Confirm

Prosi o potwierdzenie przed uruchomieniem cmdletu.

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:False
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:por

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-WhatIf

Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Cmdlet nie jest uruchomiony.

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:False
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:Wi

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

CommonParameters

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

Dane wyjściowe

FileInfo

To polecenie cmdlet zwraca obiekt FileInfo reprezentujący plik tymczasowy.