New-Item

>

Sintaxe

New-Item <String> 

New-Item <String>] -Name <String> 

Descrição

ONew-Item cmdlet cria um novo item e define o seu valor. Os tipos de itens que podem ser criados dependem da localização do item. Por exemplo, no sistema de arquivos, New-Item cria arquivos e pastas. No registro, New-Item cria chaves de registro e entradas.

New-Item também pode definir o valor dos itens que ele cria. Por exemplo, quando cria um novo ficheiro, New-Item pode adicionar conteúdo inicial ao ficheiro.

Exemplos

Exemplo 1: Cria um ficheiro no directório actual

Este comando cria um ficheiro de texto que se chama “testfile1.txt” no directório actual. O ponto(‘.’) no valor do parâmetro Path indica o diretório atual. O texto citado que segue o parâmetro Value é adicionado ao ficheiro como content.

New-Item -Path . -Name "testfile1.txt" -ItemType "file" -Value "This is a text string."

Exemplo 2: Cria um directório

Este comando cria um directório chamado “Logfiles” na drive C:. Os parâmetros ItemType especificam que o novo item é um directório, não um ficheiro ou outro objecto de sistema de ficheiros.

New-Item -Path "c:\" -Name "logfiles" -ItemType "directory"

Exemplo 3: Cria um perfil

Este comando cria um perfil PowerShell no caminho que é especificado pelo ficheiro $profile variável.

Pode usar perfis para personalizar o PowerShell. $profile é uma variável automática (incorporada) que armazena o caminho e nome do ficheiro do perfil “CurrentUser/CurrentHost”. Por defeito, o perfil não existe, apesar do PowerShell armazenar um caminho e nome de ficheiro para ele.

Neste comando, a variável $profile representa o caminho do ficheiro. ItemType parameterspecifies that the command creates a file. O parâmetro Force permite que você crie um arquivo no caminho do perfil, mesmo quando os diretórios no caminho não existem.

Após criar um perfil, você pode inserir apelidos, funções e scripts no perfil para personalizar seu shell.

Para mais informações, veja about_Automatic_Variablesand about_Profiles.

New-Item -Path $profile -ItemType "file" -Force

Exemplo 4: Crie um directório num directório diferente

Este exemplo cria um novo directório Scripts no directório “C:\PS-Test”.

O nome do novo item de directório, “Scripts”, está incluído no valor do parâmetro Path, em vez de ser especificado no valor de Name. Como indicado pela sintaxe, qualquer comando formis válido.

New-Item -ItemType "directory" -Path "c:\ps-test\scripts"

Exemplo 5: Criar vários ficheiros

Este exemplo cria ficheiros em dois directórios diferentes. Como o Path leva várias cadeias de caracteres, pode usá-lo para criar vários itens.

New-Item -ItemType "file" -Path "c:\ps-test\test.txt", "c:\ps-test\Logs\test.log"

Exemplo 6: Use wildcards para criar ficheiros em várias directorias

O New-Item cmdlet suporta wildcards no parâmetro Path. O comando seguinte cria um ficheirotemp.txt em todas as directorias especificadas pelos wildcards no parâmetro Path.

Get-ChildItem -Path C:\Temp\Directory: C:\TempMode LastWriteTime Length Name---- ------------- ------ ----d----- 5/15/2019 6:45 AM 1 Oned----- 5/15/2019 6:45 AM 1 Twod----- 5/15/2019 6:45 AM 1 ThreeNew-Item -Path * -Name temp.txt -ItemType File | Select-Object FullNameFullName--------C:\Temp\One\temp.txtC:\Temp\Three\temp.txtC:\Temp\Two\temp.txt

O comando Get-ChildItem cmdlet mostra três directorias sob o directório C:\Temp. Usando caracteres curinga-New-Item cmdlet cria um ficheiro temp.txt em todas as directorias sob a directoria actual. O New-Item cmdlet produz os itens que você criou, que é canalizado para Select-Object para verificar os caminhos dos arquivos recém criados.

Exemplo 7: Crie um link simbólico para um arquivo ou pasta

Este exemplo cria um link simbólico para o arquivo Notice.txt na pasta atual.

$link = New-Item -ItemType SymbolicLink -Path .\link -Target .\Notice.txt$link | Select-Object LinkType, TargetLinkType Target-------- ------SymbolicLink {.\Notice.txt}

Neste exemplo, Target é um alias para o parâmetro Value. O alvo do link simbólico pode ser um caminho relativo. Antes do PowerShell v6.2, o alvo deve ser um caminho totalmente qualificado.

Iniciando no PowerShell 7.1, você pode agora criar para um SymbolicLink para uma pasta no Windows usando o caminho arelativo.

Exemplo 8: Use o parâmetro -Force para tentar recriar pastas

Este exemplo cria uma pasta com um arquivo dentro. Em seguida, tenta criar a mesma pasta usando o parâmetro-Force. Ele não irá sobrescrever a pasta, mas simplesmente retornar o objeto pasta existente com o arquivo criado intacto.

PS> New-Item -Path .\TestFolder -ItemType DirectoryPS> New-Item -Path .\TestFolder\TestFile.txt -ItemType FilePS> New-Item -Path .\TestFolder -ItemType Directory -Force Directory: C:\Mode LastWriteTime Length Name---- ------------- ------ ----d----- 5/1/2020 8:03 AM TestFolderPS> Get-ChildItem .\TestFolder\ Directory: C:\TestFolderMode LastWriteTime Length Name---- ------------- ------ -----a---- 5/1/2020 8:03 AM 0 TestFile.txt

Exemplo 9: Use o parâmetro -Force para sobrescrever arquivos existentes

Este exemplo cria um arquivo com um valor e então recria o arquivo usando -Force. Isto sobrescreveO ficheiro existente e perderá o seu conteúdo como pode ver pela propriedade comprimento

PS> New-Item ./TestFile.txt -ItemType File -Value 'This is just a test file' Directory: C:\Source\TestMode LastWriteTime Length Name---- ------------- ------ -----a---- 5/1/2020 8:32 AM 24 TestFile.txtNew-Item ./TestFile.txt -ItemType File -Force Directory: C:\Source\TestMode LastWriteTime Length Name---- ------------- ------ -----a---- 5/1/2020 8:32 AM 0 TestFile.txt

Parâmetros

Entradas

Objecto

Pode canalizar um valor para o novo item para este cmdlet.

Entradas

Objeto

Este cmdlet retorna o item que ele cria.

Notas

New-Item foi projetado para trabalhar com os dados expostos por qualquer provedor. Para listar o provedor disponível em sua sessão, digite Get-PsProvider. Para mais informações, veja about_Providers.

• Clear-Item
• Copy-Item
• Get-Item
• Invoke-Item
• Move-Item
• Remove-Item
• Rename-Item
• Set-Item
• Set-Item
• Sobre_Provedores