New-TemporaryFile

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

Cria um arquivo temporário.

Syntax

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

Description

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

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

Esse cmdlet usa o método Path.GetTempPath() para localizar sua pasta TEMP . Esse 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 que não sejam Windows: usa o caminho especificado pela variável de ambiente TMPDIR.

Exemplos

Exemplo 1: Criar um arquivo temporário

$TempFile = New-TemporaryFile

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

Parâmetros

-Confirm

Solicita 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

Mostra o que aconteceria se o cmdlet fosse executado. 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

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