New-Item
Crea un nuovo elemento.
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>]
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. Ad esempio, nel file system, New-Item
crea file e cartelle. Nel Registro di sistema vengono New-Item
create le chiavi e le voci del Registro di sistema.
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: Create 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 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: Create 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: Create 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
Nota
Quando si crea un file usando questo metodo, il file risultante viene codificato come UTF-8 senza un byte order-mark (BOM).
Esempio 4: Create 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: Create 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"
Parametri
-Confirm
Richiede la conferma dell'utente prima di eseguire il cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Credential
Nota
Questo parametro non è supportato da alcun provider installato con PowerShell. Per rappresentare un altro utente o elevare le credenziali quando si esegue questo cmdlet, usare Invoke-Command
.
Type: | PSCredential |
Position: | Named |
Default value: | Current user |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Force
Forza questo cmdlet a creare un elemento che scrive su un elemento di sola lettura esistente. L'implementazione varia a seconda del provider. Per altre informazioni, vedere about_Providers. Anche usando il parametro Force , il cmdlet non può eseguire l'override delle restrizioni di sicurezza.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ItemType
Specifica il tipo specificato dal provider del nuovo elemento. I valori disponibili di questo parametro dipendono dal provider corrente in uso.
Se la posizione si trova in un'unità FileSystem
, sono consentiti i valori seguenti:
- File
- Directory
- Collegamento simbolico
- giunzione
- HardLink
Quando si crea un file usando questo metodo, il file risultante viene codificato come UTF-8 senza un byte order-mark (BOM).
In un'unità Certificate
, questi sono i valori che è possibile specificare:
- Provider Certificate
- Certificato
- Archiviazione
- StoreLocation
Per altre informazioni, vedere about_Providers.
Type: | String |
Aliases: | Type |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
Specifica il nome del nuovo elemento.
È possibile specificare il nome del nuovo elemento nel valore del parametro Name o Path ed è possibile specificare il percorso del nuovo elemento in Nome o Percorso valore.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Path
Specifica il percorso del nuovo elemento. I caratteri jolly sono consentiti.
È possibile specificare il nome del nuovo elemento in Nome o includerlo in Path.
Type: | String[] |
Position: | 0 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | True |
-UseTransaction
Include il comando nella transazione attiva. Questo parametro è valido solo quando è in corso una transazione. Per altre informazioni, vedere about_Transactions.
Type: | SwitchParameter |
Aliases: | usetx |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Value
Specifica il valore del nuovo elemento. È anche possibile inviare tramite pipe un valore a New-Item
.
Type: | Object |
Aliases: | Target |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WhatIf
Mostra l'esito in caso di esecuzione del cmdlet. Il cmdlet non viene eseguito.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Input
È possibile inviare tramite pipe un valore per il nuovo elemento a questo cmdlet.
Output
Questo cmdlet restituisce l'elemento creato.
Note
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.