Compartilhar via


New-TemporaryFile

Cria um arquivo temporário.

Sintaxe

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 . 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

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.

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Saídas

FileInfo

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