New-ItemProperty

  • Riferimento
Modulo:
Microsoft.PowerShell.Management

Crea una nuova proprietà per un elemento e ne imposta il valore.

Sintassi

New-ItemProperty
   [-Path] <String[]>
   [-Name] <String>
   [-PropertyType <String>]
   [-Value <Object>]
   [-Force]
   [-Filter <String>]
   [-Include <String[]>]
   [-Exclude <String[]>]
   [-Credential <PSCredential>]
   [-WhatIf]
   [-Confirm]
   [-UseTransaction]
   [<CommonParameters>]
New-ItemProperty
   -LiteralPath <String[]>
   [-Name] <String>
   [-PropertyType <String>]
   [-Value <Object>]
   [-Force]
   [-Filter <String>]
   [-Include <String[]>]
   [-Exclude <String[]>]
   [-Credential <PSCredential>]
   [-WhatIf]
   [-Confirm]
   [-UseTransaction]
   [<CommonParameters>]

Descrizione

Il New-ItemProperty cmdlet crea una nuova proprietà per un elemento specificato e ne imposta il valore. Questo cmdlet viene in genere usato per creare nuovi valori del Registro di sistema, perché i valori del Registro di sistema sono proprietà di un elemento chiave del Registro di sistema.

Questo cmdlet non aggiunge proprietà a un oggetto.

  • Per aggiungere una proprietà a un'istanza di un oggetto, utilizzare il Add-Member cmdlet .
  • Per aggiungere una proprietà a tutti gli oggetti di un particolare tipo, modificare il file Types.ps1xml.

Esempio

Esempio 1: Aggiungere una voce del Registro di sistema

Questo comando aggiunge una nuova voce del Registro di sistema, NoOfEmployees, alla MyCompany chiave di HKLM:\Software hive.

Il primo comando usa il parametro Path per specificare il percorso della chiave del MyCompany Registro di sistema. Usa il parametro Name per specificare un nome per la voce e il parametro Value per specificarne il valore.

Il secondo comando usa il Get-ItemProperty cmdlet per visualizzare la nuova voce del Registro di sistema.

New-ItemProperty -Path "HKLM:\Software\MyCompany" -Name "NoOfEmployees" -Value 822
Get-ItemProperty "HKLM:\Software\MyCompany"

PSPath        : Microsoft.PowerShell.Core\Registry::HKEY_LOCAL_MACHINE\software\mycompany
PSParentPath  : Microsoft.PowerShell.Core\Registry::HKEY_LOCAL_MACHINE\software
PSChildName   : mycompany
PSDrive       : HKLM
PSProvider    : Microsoft.PowerShell.Core\Registry
NoOfLocations : 2
NoOfEmployees : 822

Esempio 2: Aggiungere una voce del Registro di sistema a una chiave

Questo comando aggiunge una nuova voce del Registro di sistema a una chiave del Registro di sistema. Per specificare la chiave, usa un operatore pipeline (|) per inviare un oggetto che rappresenta la chiave a New-ItemProperty.

La prima parte del comando usa il Get-Item cmdlet per ottenere la chiave del MyCompany Registro di sistema. L'operatore pipeline invia i risultati del comando a New-ItemProperty, che aggiunge la nuova voce del Registro di sistema (NoOfLocations) e il relativo valore (3) alla MyCompany chiave.

Get-Item -Path "HKLM:\Software\MyCompany" | New-ItemProperty -Name NoOfLocations -Value 3

Questo comando funziona perché la funzionalità di associazione di parametri di Windows PowerShell associa il percorso dell'oggetto RegistryKey che Get-Item restituisce al parametro LiteralPath di New-ItemProperty. Per altre informazioni, vedere about_Pipelines.

Esempio 3: Creare un valore MultiString nel Registro di sistema usando un oggetto Here-String

In questo esempio viene creato un MultiString valore usando un oggetto Here-String.

$newValue = New-ItemProperty -Path "HKLM:\SOFTWARE\ContosoCompany\" -Name 'HereString' -PropertyType MultiString -Value @"
This is text which contains newlines
It can also contain "quoted" strings
"@
$newValue.multistring

This is text which contains newlines
It can also contain "quoted" strings

Esempio 4: Creare un valore MultiString nel Registro di sistema usando una matrice

Nell'esempio viene illustrato come usare una matrice di valori per creare il MultiString valore.

$newValue = New-ItemProperty -Path "HKLM:\SOFTWARE\ContosoCompany\" -Name 'MultiString' -PropertyType MultiString -Value ('a','b','c')
$newValue.multistring[0]

a

Parametri

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Credential

Specifica un account utente che dispone delle autorizzazioni per eseguire questa azione. Il valore predefinito è l'utente corrente.

Digitare un nome utente, ad esempio User01 o Domain01\User01, o immettere un oggetto PSCredential , ad esempio quello generato dal Get-Credential cmdlet . Se si digita un nome utente, viene richiesta una password.

Nota

Questo parametro non è supportato da alcun provider installato con PowerShell. Per rappresentare un altro utente o elevare le credenziali durante l'esecuzione di questo cmdlet, usare Invoke-Command.

Tipo:PSCredential
Posizione:Named
Valore predefinito:Current user
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Exclude

Specifica, come matrice di stringhe, una proprietà o una proprietà che questo cmdlet esclude dall'operazione. Il valore di questo parametro qualifica il parametro Path . Immettere un elemento o un modello di percorso, ad esempio *.txt. I caratteri jolly sono consentiti.

Tipo:String[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Filter

Specifica un filtro nel formato o nella lingua del provider. Il valore di questo parametro qualifica il parametro Path .

La sintassi del filtro, incluso l'uso di caratteri jolly, dipende dal provider. I filtri sono più efficienti rispetto ad altri parametri, perché il provider li applica quando il cmdlet ottiene gli oggetti anziché filtrare gli oggetti dopo il recupero.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Force

Forza il cmdlet a creare una proprietà su un oggetto a cui non è possibile accedere in altro modo dall'utente. L'implementazione varia a seconda del provider. Per altre informazioni, vedere about_Providers.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Include

Specifica, come matrice di stringhe, un elemento o elementi inclusi nel cmdlet nell'operazione. Il valore di questo parametro qualifica il parametro Path . Immettere un elemento o un modello di percorso, ad esempio *.txt. I caratteri jolly sono consentiti. Il parametro Include è effettivo solo quando il comando include il contenuto di un elemento, ad esempio C:\Windows\*, dove il carattere jolly specifica il contenuto della C:\Windows directory.

Tipo:String[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-LiteralPath

Specifica un percorso di una o più posizioni. Il valore di LiteralPath viene usato esattamente come viene tipizzato. Nessun carattere viene interpretato come carattere jolly. Se il percorso include caratteri di escape, racchiuderlo tra virgolette singole ('). Le virgolette singole indicano a PowerShell di non interpretare alcun carattere come sequenze di escape.

Per altre informazioni, vedere about_Quoting_Rules.

Tipo:String[]
Alias:PSPath
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Name

Specifica un nome per la nuova proprietà. Se la proprietà è una voce del Registro di sistema, questo parametro specifica il nome della voce.

Tipo:String
Alias:PSProperty
Posizione:1
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Path

Specifica il percorso dell'elemento. Questo parametro identifica l'elemento a cui questo cmdlet aggiunge la nuova proprietà.

Tipo:String[]
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-PropertyType

Specifica il tipo di proprietà aggiunta da questo cmdlet. I valori validi per questo parametro sono:

  • String: specifica una stringa con terminazione Null. Utilizzato per i valori di REG_SZ .
  • ExpandString: specifica una stringa con terminazione Null che contiene riferimenti non espansi alle variabili di ambiente espanse quando viene recuperato il valore. Utilizzato per i valori REG_EXPAND_SZ .
  • Binary: specifica i dati binari in qualsiasi formato. Utilizzato per i valori REG_BINARY .
  • DWord: specifica un numero binario a 32 bit. Utilizzato per i valori REG_DWORD .
  • MultiString: specifica una matrice di stringhe con terminazione Null di due caratteri Null. Utilizzato per i valori REG_MULTI_SZ .
  • Qword: specifica un numero binario a 64 bit. Utilizzato per i valori REG_QWORD .
  • Unknown: indica un tipo di dati del Registro di sistema non supportato, ad esempio REG_RESOURCE_LIST valori.
Tipo:String
Alias:Type
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-UseTransaction

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

Tipo:SwitchParameter
Alias:usetx
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Value

Specifica il valore della proprietà. Se la proprietà è una voce del Registro di sistema, questo parametro specifica il valore della voce.

Tipo:Object
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-WhatIf

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

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

None

Non è possibile inviare tramite pipe oggetti a questo cmdlet.

Output

PSCustomObject

Questo cmdlet restituisce un oggetto personalizzato che rappresenta la nuova proprietà.

Note

New-ItemProperty è 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.