Sintassi
mkdir <String> mkdir <String>] -Name <String> Descrizione
Il cmdlet New-Item crea un nuovo elemento e ne imposta il valore.I tipi di elementi che possono essere creati dipendono dalla posizione dell’elemento.Per esempio, nel file system, New-Item è usato per creare file e cartelle.Nel registro, New-Item crea chiavi e voci di registro.
New-Item può anche impostare il valore degli elementi che crea.Per esempio, quando si crea un nuovo file, New-Item può aggiungere il contenuto iniziale al file.
Esempi
————————– ESEMPIO 1 ————————–
PS C:\>new-item -path . -name testfile1.txt -itemtype "file" -value "This is a text string."Questo comando crea un file di testo chiamato testfile1.txt nella directory corrente.Il punto (.) nel valore del parametro Path indica la directory corrente.Il testo citato che segue il parametro Value viene aggiunto al file come contenuto.
————————– ESEMPIO 2 ————————–
PS C:\>new-item -path c:\ -name logfiles -itemtype directoryQuesto comando crea una directory chiamata Logfiles nell’unità C:.Il parametro ItemType specifica che il nuovo elemento è una directory, non un file o un altro oggetto del file system.
————————– ESEMPIO 3 ————————–
PS C:\>new-item -path $profile -itemtype file -forceQuesto comando crea un profilo Windows PowerShell nel percorso specificato dalla variabile $profile.
Puoi usare i profili per personalizzare Windows PowerShell.$Profile è una variabile automatica (incorporata) che memorizza il percorso e il nome del file del profilo CurrentUser/CurrentHost.Per default, il profilo non esiste, anche se Windows PowerShell memorizza un percorso e un nome di file per esso.
In questo comando, la variabile $profile rappresenta il percorso del file.Il parametro ItemType specifica che il comando crea un file.Il parametro Force permette di creare un file nel percorso del profilo, anche quando le directory nel percorso non esistono (Windows PowerShell le crea).
Dopo aver usato questo comando per creare un profilo, puoi inserire alias, funzioni e script nel profilo per personalizzare la tua shell.
Per maggiori informazioni, vedere about_Automatic_Variables e about_Profiles.
————————– ESEMPIO 4 ————————–
PS C:\>new-item -itemtype directory -path c:\ps-test\scriptsQuesto comando crea una nuova directory Scripts nella directory C:\PS-Test.
Il nome del nuovo elemento della directory, Scripts, è incluso nel valore del parametro Path, invece di essere specificato nel valore del parametro Name.Come indicato dalla sintassi, entrambe le forme di comando sono valide.
————————– ESEMPIO 5 ————————–
PS C:\>new-item -itemtype file -path "c:\ps-test\test.txt", "c:\ps-test\Logs\test.log"Questo comando usa il cmdlet New-Item per creare file in due diverse directory.Poiché il parametro Path accetta più stringhe, puoi usarlo per creare più elementi.
Parametri richiesti
Specifica il nome del nuovo elemento.
Puoi specificare il nome del nuovo elemento nel valore del parametro Name o Path, e puoi specificare il percorso del nuovo elemento nel valore del parametro Name o Path.
| Tipo: | |
| Posizione: | Named |
| Valore predefinito: | Nessuno |
| Accetta l’input della pipeline: | True (ByPropertyName) |
| Accetta caratteri jolly: |
Specifica il percorso della posizione del nuovo elemento.
Puoi specificare il nome del nuovo elemento nel parametro Name, o includerlo nel parametro Path.
| Tipo: | |
| Posizione: | |
| Valore predefinito: | |
| Nessuno | |
| Accetta l’input della pipeline: | True (ByPropertyName) |
| Accetta caratteri jolly: |
Parametri opzionali
Ti chiede conferma prima di eseguire la cmdlet.
| Tipo: | SwitchParameter |
| Alias: | |
| Posizione: | Named |
| Valore predefinito: | Falso |
| Accetta l’input della pipeline: | |
| Accetta i caratteri jolly: |
Specifica un account utente che ha il permesso di eseguire questa azione.
Digita un nome utente, come “User01” o “Domain01\User01”, o inserisci un oggetto PSCredential, come uno generato dalla cmdlet Get-Credential.Se digiti un nome utente, ti verrà richiesta una password.
Questo parametro non è supportato da nessun provider installato con Windows PowerShell
| Tipo: | PSCredential |
| Posizione: | Named |
| Valore predefinito: | Nessuno |
| Accetta l’input della pipeline: | True (ByPropertyName) |
| Accetta caratteri jolly: |
Permette al cmdlet di creare un elemento che scrive su un elemento esistente di sola lettura.L’implementazione varia da provider a provider.Per maggiori informazioni, vedere about_Providers.Anche usando il parametro Force, il cmdlet non può annullare le restrizioni di sicurezza.
| Tipo: | SwitchParameter |
| Posizione: | Named |
| Valore predefinito: | Nessuno |
| Accetta l’input della pipeline: | |
| Accetta i caratteri jolly: |
Include il comando nella transazione attiva.Questo parametro è valido solo quando una transazione è in corso:
usetx
Falso
Falso
Specifica il valore del nuovo elemento.
| Tipo: | |
| Posizione: | Named |
| Valore predefinito: | Nessuno |
| Accetta l’input della pipeline: | True (ByPropertyName, ByValue) |
| Accetta caratteri jolly: |
Mostra cosa accadrebbe se il cmdlet venisse eseguito.
| Tipo: | SwitchParameter |
| Alias: | |
| Posizione: | Named |
| Valore predefinito: | Falso |
| Accetta l’input della pipeline: | |
| Accetta i caratteri jolly: |
Input
System.Object
Puoi inserire un valore per il nuovo elemento nella cmdlet New-Item.
Uscite
System.Object
New-Item restituisce l’elemento che crea.
Note
Il cmdlet New-Item è progettato per lavorare con i dati esposti da qualsiasi provider.Per elencare i provider disponibili nella tua sessione, digita “Get-PsProvider”.Per maggiori informazioni, vedi about_Providers.
- Clear-Item
- Copy-Item
- Get-Item
- Invoke-Item
- Move-Item
- Remove-Item
- Rename-Item
- Set-Item
- about_Providers