Compartilhar via

New-TemporaryFile

Módulo:
Microsoft.PowerShell.Utility Module

Cria um arquivo temporário.

Sintaxe

Default (Default) 

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

Description

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

O cmdlet New-TemporaryFile cria um arquivo vazio que tem a extensão de nome de arquivo .tmp. Esse cmdlet nomeia o arquivo tmp<NNNN>.tmp, em que <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 são do 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 arquivo .tmp em sua pasta temporária e armazena uma referência ao arquivo na variável $TempFile. Você pode usar esse arquivo posteriormente em seu script.

Parâmetros

-Confirm

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

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:False
Dá suporte a curingas:False
DontShow:False
Aliases:cf

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-WhatIf

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

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:False
Dá suporte a curingas:False
DontShow:False
Aliases:wi

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Saídas

FileInfo

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