Partilhar via

New-TemporaryFile

Módulo:
Microsoft.PowerShell.Utility Module

Cria um arquivo temporário.

Sintaxe

Default (Predefinição) 

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

Description

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

O cmdlet New-TemporaryFile cria um arquivo vazio com a extensão de nome de arquivo .tmp. Este cmdlet nomeia o arquivo tmp<NNNN>.tmp, onde <NNNN> é um número hexadecimal aleatório. O cmdlet cria o ficheiro 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 ficheiro .tmp na pasta temporária e, em seguida, armazena uma referência ao ficheiro na variável $TempFile. Você pode usar esse arquivo posteriormente em seu script.

Parâmetros

-Confirm

Solicita confirmação antes de executar o cmdlet.

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:False
Suporta carateres universais:False
NãoMostrar:False
Aliases:Cf.

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-WhatIf

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

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:False
Suporta carateres universais:False
NãoMostrar:False
Aliases:Wi

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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

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