New-Item

Sintassi

New-Item
   [-Path] <string[]>
   [-ItemType <string>]
   [-Value <Object>]
   [-Force]
   [-Credential <pscredential>]
   [-WhatIf]
   [-Confirm]
   [-UseTransaction]
   [<CommonParameters>]

New-Item
   [[-Path] <string[]>]
   -Name <string>
   [-ItemType <string>]
   [-Value <Object>]
   [-Force]
   [-Credential <pscredential>]
   [-WhatIf]
   [-Confirm]
   [-UseTransaction]
   [<CommonParameters>]

New-Item
   [-Path] <string[]>
   -ConnectionURI <uri>
   [-ItemType <string>]
   [-Value <Object>]
   [-Force]
   [-Credential <pscredential>]
   [-WhatIf]
   [-Confirm]
   [-UseTransaction]
   [-OptionSet <hashtable>]
   [-Authentication <AuthenticationMechanism>]
   [-CertificateThumbprint <string>]
   [-SessionOption <SessionOption>]
   [-Port <int>]
   [<CommonParameters>]

New-Item
   [[-Path] <string[]>]
   -Name <string>
   [-ItemType <string>]
   [-Value <Object>]
   [-Force]
   [-Credential <pscredential>]
   [-WhatIf]
   [-Confirm]
   [-UseTransaction]
   [-OptionSet <hashtable>]
   [-Authentication <AuthenticationMechanism>]
   [-CertificateThumbprint <string>]
   [-SessionOption <SessionOption>]
   [-ApplicationName <string>]
   [-Port <int>]
   [-UseSSL]
   [<CommonParameters>]

New-Item
   [-Path] <string[]>
   [-ItemType <string>]
   [-Value <Object>]
   [-Force]
   [-Credential <pscredential>]
   [-WhatIf]
   [-Confirm]
   [-UseTransaction]
   [-Options <ScopedItemOptions>]
   [<CommonParameters>]

New-Item
   [[-Path] <string[]>]
   -Name <string>
   [-ItemType <string>]
   [-Value <Object>]
   [-Force]
   [-Credential <pscredential>]
   [-WhatIf]
   [-Confirm]
   [-UseTransaction]
   [-Options <ScopedItemOptions>]
   [<CommonParameters>]

Descrizione

Il New-Item cmdlet crea un nuovo elemento e ne imposta il valore. I tipi di elementi che possono essere creati dipendono dalla posizione dell'elemento. Nel file system, ad esempio, New-Item crea file e cartelle. Nel Registro di sistema vengono create le chiavi e le voci del Registro di sistema New-Item .

New-Item può anche impostare il valore degli elementi creati. Ad esempio, quando crea un nuovo file, New-Item può aggiungere contenuto iniziale al file.

Esempio

Esempio 1: Creare un file nella directory corrente

Questo comando crea un file di testo denominato "testfile1.txt" nella directory corrente. Il punto ('.') nel valore del parametro Path indica la directory corrente. Il testo racchiuso tra virgolette che segue il parametro Value viene aggiunto al file come contenuto.

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

Esempio 2: Creare una directory

Questo comando crea una directory denominata "Logfiles" nell'unità C: . Il parametro ItemType specifica che il nuovo elemento è una directory, non un file o un altro oggetto file system.

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

Esempio 3: Creare un profilo

Questo comando crea un profilo di PowerShell nel percorso specificato dalla $profile variabile .

È possibile usare i profili per personalizzare PowerShell. $profile è una variabile automatica (predefinita) che archivia il percorso e il nome file del profilo "CurrentUser/CurrentHost". Per impostazione predefinita, il profilo non esiste, anche se PowerShell archivia un percorso e un nome di file.

In questo comando la $profile variabile rappresenta il percorso del file. Il parametro ItemType specifica che il comando crea un file. Il parametro Force consente di creare un file nel percorso del profilo, anche quando le directory nel percorso non esistono.

Dopo aver creato un profilo, è possibile immettere alias, funzioni e script nel profilo per personalizzare la shell.

Per altre informazioni, vedere about_Automatic_Variables e about_Profiles.

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

Esempio 4: Creare una directory in una directory diversa

In questo esempio viene creata una nuova directory Scripts nella directory "C:\PS-Test".

Il nome del nuovo elemento di directory, "Scripts", è incluso nel valore del parametro Path , anziché essere specificato nel valore di Name. Come indicato dalla sintassi, entrambe le forme sono valide.

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

Esempio 5: Creare più file

In questo esempio vengono creati file in due directory diverse. Poiché Path accetta più stringhe, è possibile usarlo per creare più elementi.

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

Esempio 6: Usare caratteri jolly per creare file in più directory

Il New-Item cmdlet supporta i caratteri jolly nel parametro Path . Il comando seguente crea un temp.txt file in tutte le directory specificate dai caratteri jolly nel parametro Path .

Get-ChildItem -Path C:\Temp\

Directory:  C:\Temp

Mode                LastWriteTime     Length Name
----                -------------     ------ ----
d-----        5/15/2019   6:45 AM        1   One
d-----        5/15/2019   6:45 AM        1   Two
d-----        5/15/2019   6:45 AM        1   Three

New-Item -Path C:\Temp\* -Name temp.txt -ItemType File | Select-Object FullName

FullName
--------
C:\Temp\One\temp.txt
C:\Temp\Three\temp.txt
C:\Temp\Two\temp.txt

Il Get-ChildItem cmdlet mostra tre directory nella C:\Temp directory . Usando i caratteri jolly, il New-Item cmdlet crea un temp.txt file in tutte le directory nella directory corrente. Il New-Item cmdlet restituisce gli elementi creati, che viene inviato tramite pipe a Select-Object per verificare i percorsi dei file appena creati.

Esempio 7: Creare un collegamento simbolico a un file o una cartella

In questo esempio viene creato un collegamento simbolico al file Notice.txt nella cartella corrente.

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

LinkType     Target
--------     ------
SymbolicLink {.\Notice.txt}

In questo esempio Target è un alias per il parametro Value. La destinazione del collegamento simbolico deve essere un percorso completo.

Esempio 8: Usare il parametro -Force per tentare di ricreare le cartelle

In questo esempio viene creata una cartella con un file all'interno di . Tenta quindi di creare la stessa cartella usando -Force. Non sovrascriverà la cartella, ma restituirà semplicemente l'oggetto cartella esistente con il file creato intatto.

PS> New-Item -Path .\TestFolder -ItemType Directory
PS> New-Item -Path .\TestFolder\TestFile.txt -ItemType File

PS> New-Item -Path .\TestFolder -ItemType Directory -Force

    Directory: C:\
Mode                LastWriteTime         Length Name
----                -------------         ------ ----
d-----         5/1/2020   8:03 AM                TestFolder

PS> Get-ChildItem .\TestFolder\

    Directory: C:\TestFolder
Mode                LastWriteTime         Length Name
----                -------------         ------ ----
-a----         5/1/2020   8:03 AM              0 TestFile.txt

Esempio 9: Usare il parametro -Force per sovrascrivere i file esistenti

In questo esempio viene creato un file con un valore e quindi viene ricreato il file usando -Force. In questo modo viene sovrascritto il file esistente, come si può vedere dalla proprietà length.

PS> New-Item ./TestFile.txt -ItemType File -Value 'This is just a test file'

    Directory: C:\Source\Test
Mode                LastWriteTime         Length Name
----                -------------         ------ ----
-a----         5/1/2020   8:32 AM             24 TestFile.txt

New-Item ./TestFile.txt -ItemType File -Force

    Directory: C:\Source\Test
Mode                LastWriteTime         Length Name
----                -------------         ------ ----
-a----         5/1/2020   8:32 AM              0 TestFile.txt

Parametri

-ApplicationName

-Authentication

-CertificateThumbprint

-Confirm

-ConnectionURI

-Credential

-Force

-ItemType

-Name

-Options

-OptionSet

-Path

-Port

-SessionOption

-UseSSL

-UseTransaction

-Value

-WhatIf

Input

Object

È possibile inviare tramite pipe un valore per il nuovo elemento a questo cmdlet.

Output

DictionaryEntry

Il cmdlet restituisce un oggetto DictionaryEntry durante la creazione di una nuova variabile di ambiente.

DirectoryInfo

Il cmdlet restituisce un oggetto DirectoryInfo durante la creazione di una nuova directory nel file system.

FileInfo

Il cmdlet restituisce un oggetto FileInfo durante la creazione di un nuovo file nel file system.

AliasInfo

Il cmdlet restituisce un oggetto AliasInfo durante la creazione di un nuovo alias.

FunctionInfo

Il cmdlet restituisce un oggetto FunctionInfo durante la creazione di una nuova funzione.

PSVariable

Il cmdlet restituisce un oggetto PSVariable durante la creazione di una nuova variabile.

Note

Windows PowerShell include gli alias seguenti per New-Item:

• ni

New-Item è progettato per lavorare con i dati esposti da qualsiasi provider. Per elencare i provider disponibili nella sessione, digitare Get-PsProvider. Per altre informazioni, vedere about_Providers.

Collegamenti correlati

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