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 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:
- O caminho especificado pela variável de ambiente TMP.
- O caminho especificado pela variável de ambiente TEMP.
- O caminho especificado pela variável de ambiente USERPROFILE.
- 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 a 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
Esse cmdlet retorna um objeto FileInfo que representa o arquivo temporário.