New-TemporaryFile

  • Referência
Módulo:
Microsoft.PowerShell.Utility

Cria um arquivo temporário.

Syntax

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

Description

Este cmdlet cria arquivos temporários que você pode usar em scripts.

O New-TemporaryFile cmdlet cria um arquivo vazio com a extensão de nome de .tmp arquivo. Este cmdlet nomeia o arquivo tmp<NNNN>.tmp, onde <NNNN> é um número hexadecimal aleatório. O cmdlet cria o arquivo na pasta TEMP .

Este cmdlet usa o método Path.GetTempPath() para localizar sua pasta TEMP . Este método verifica a existência de variáveis de ambiente na seguinte ordem e usa o primeiro caminho encontrado:

  • Em plataformas Windows:

    1. O caminho especificado pela variável de ambiente TMP.
    2. O caminho especificado pela variável de ambiente TEMP.
    3. O caminho especificado pela variável de ambiente USERPROFILE.
    4. O diretório do Windows.

  • Em plataformas não-Windows: Usa o caminho especificado pela variável de ambiente TMPDIR.

Exemplos

Exemplo 1: Criar um arquivo temporário

$TempFile = New-TemporaryFile

Este comando gera um .tmp ficheiro na pasta temporária e, em seguida, armazena uma referência ao ficheiro na $TempFile variável. Você pode usar esse arquivo posteriormente em seu script.

Parâmetros

-Confirm

Solicita a sua confirmação antes de executar o cmdlet.

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

-WhatIf

Apresenta o que aconteceria mediante a execução do cmdlet. O cmdlet não é executado.

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

Saídas

FileInfo

Este cmdlet retorna um objeto FileInfo que representa o arquivo temporário.