Condividi tramite

New-Item

Modulo:
Microsoft.PowerShell.Management Module

Crea un nuovo elemento.

Sintassi

pathSet (Impostazione predefinita) 

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

nameSet 

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. 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

Annotazioni

Quando si crea un file usando questo metodo, il file risultante viene codificato come UTF-8 senza un byte-order-mark (BOM).

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"

Parametri

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:False
Supporta i caratteri jolly:False
DontShow:False
Alias:cfr

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Credential

Annotazioni

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.

Proprietà dei parametri

Tipo:PSCredential
Valore predefinito:Current user
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-Force

Forza questo cmdlet a creare un elemento che scrive su un elemento di sola lettura esistente. L'implementazione varia da provider a provider. Per altre informazioni, consultare about_Providers. Anche usando il parametro Force, il cmdlet non può eseguire l'override delle restrizioni di sicurezza.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti: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:

  • Documento
  • 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:

  • Fornitore di certificati
  • Certificato
  • Negozio
  • Posizione del Negozio

Per altre informazioni, vedere about_Providers.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:TIPO

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti: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 .

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

nameSet
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-Path

Specifica il percorso del nuovo elemento. Sono consentiti caratteri jolly.

È possibile specificare il nome del nuovo elemento in Nome o includerlo in Path.

Proprietà dei parametri

Tipo:

String[]

Valore predefinito:None
Supporta i caratteri jolly:True
DontShow:False

Set di parametri

pathSet
Posizione:0
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False
nameSet
Posizione:0
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-UseTransaction

Include il comando nella transazione attiva. Questo parametro è valido solo quando è in corso una transazione. Per altre informazioni, vedere about_Transactions.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:False
Supporta i caratteri jolly:False
DontShow:False
Alias:usetx

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Value

Specifica il valore del nuovo elemento. È anche possibile inviare tramite pipe un valore a New-Item.

Proprietà dei parametri

Tipo:Object
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:Obiettivo

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-WhatIf

Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:False
Supporta i caratteri jolly:False
DontShow:False
Alias:Wi

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.

Input

Object

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

Output

Object

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, consultare about_Providers.