Crea una nuova proprietà per un elemento e ne imposta il valore. Ad esempio, è possibile utilizzare New-ItemProperty per creare e modificare valori e dati del Registro di sistema che sono proprietà di una chiave del Registro di sistema.
Sintassi
New-ItemProperty [-LiteralPath] <string[]> [-Name] <string> [-Credential <PSCredential>] [-Exclude <string[]>] [-Filter <string>] [-Force] [-Include <string[]>] [-PropertyType <string>] [-Value <Object>] [-Confirm] [-WhatIf] [-UseTransaction] [<CommonParameters>] New-ItemProperty [-Path] <string[]> [-Name] <string> [-Credential <PSCredential>] [-Exclude <string[]>] [-Filter <string>] [-Force] [-Include <string[]>] [-PropertyType <string>] [-Value <Object>] [-Confirm] [-WhatIf] [-UseTransaction] [<CommonParameters>]
Descrizione
Il cmdlet New-ItemProperty crea una nuova proprietà per un elemento specificato e ne imposta il valore. In genere, questo cmdlet viene utilizzato per creare nuovi valori del Registro di sistema, perché tali valori sono proprietà di un elemento chiave del Registro di sistema.
Questo cmdlet non consente di aggiungere proprietà a un oggetto. Per aggiungere una proprietà a un'istanza di un oggetto, utilizzare il cmdlet Add-Member. Per aggiungere una proprietà a tutti gli oggetti di un determinato tipo, modificare il file Types.ps1xml.
Parametri
-Credential <PSCredential>
Specifica un account utente con autorizzazione per l'esecuzione di questa azione. Il valore predefinito è l'utente corrente.
Digitare un nome utente, ad esempio "Utente01" o "Dominio01\Utente01", o immettere un oggetto PSCredential, ad esempio uno generato dal cmdlet Get-Credential. Se si digita un nome utente, viene richiesta una password.
Questo parametro non è supportato dai provider installati con Windows PowerShell.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
true (ByPropertyName) |
|
Accettare caratteri jolly? |
false |
-Exclude <string[]>
Omette gli elementi specificati. È consentito l'utilizzo di caratteri jolly.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
-Filter <string>
Specifica un filtro nel formato o nel linguaggio del provider. Il valore di questo parametro qualifica il parametro Path.
La sintassi del filtro, incluso l'utilizzo dei caratteri jolly, dipende dal provider. I filtri sono più efficienti rispetto ad altri parametri, perché il provider li applica al momento del recupero degli oggetti, anziché utilizzare Windows PowerShell per filtrare gli oggetti dopo il recupero.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
-Force
Consente al cmdlet di creare una proprietà su un oggetto altrimenti inaccessibile all'utente. L'implementazione varia a seconda del provider. Per ulteriori informazioni, vedere about_Providers.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
-Include <string[]>
Il valore di questo parametro qualifica il parametro Path. Immettere un criterio o un elemento del percorso, ad esempio "*.txt". È consentito l'utilizzo di caratteri jolly.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
-LiteralPath <string[]>
Specifica un percorso della proprietà dell'elemento. Il valore di LiteralPath viene utilizzato così come viene digitato. Nessun carattere viene interpretato come carattere jolly. Se il percorso include caratteri di escape, è necessario racchiuderli tra virgolette singole tramite le quali si comunica a Windows PowerShell di non interpretare alcun carattere come sequenza di escape.
|
Obbligatorio? |
true |
|
Posizione? |
1 |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
true (ByPropertyName) |
|
Accettare caratteri jolly? |
false |
-Name <string>
Specifica un nome per la nuova proprietà. Se la proprietà è una voce del Registro di sistema, il parametro specifica il nome della voce.
|
Obbligatorio? |
true |
|
Posizione? |
2 |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
true (ByPropertyName) |
|
Accettare caratteri jolly? |
false |
-Path <string[]>
Specifica il percorso dell'elemento. Questo parametro identifica l'elemento al quale verrà aggiunta la nuova proprietà.
|
Obbligatorio? |
true |
|
Posizione? |
1 |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
-PropertyType <string>
Specifica il tipo di proprietà che verrà aggiunta.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
true (ByPropertyName) |
|
Accettare caratteri jolly? |
false |
-Value <Object>
Specifica il valore della proprietà. Se la proprietà è una voce del Registro di sistema, il parametro specifica il valore della voce.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
true (ByPropertyName) |
|
Accettare caratteri jolly? |
false |
-Confirm
Chiede una conferma prima di eseguire il comando.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
-WhatIf
Descrive ciò che accadrebbe se si eseguisse il comando senza eseguirlo realmente.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
-UseTransaction
Include il comando nella transazione attiva. Questo parametro è valido solo quando è in corso una transazione. Per ulteriori informazioni, vedere about_Transactions.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
<CommonParameters>
Questo cmdlet supporta i parametri comuni -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Per ulteriori informazioni, vedere about_Commonparameters.
Input e output
Il tipo di input è il tipo degli oggetti che è possibile reindirizzare al cmdlet. Il tipo restituito è il tipo degli oggetti restituiti dal cmdlet.
|
Input |
Nessuno Non è possibile reindirizzare l'input a New-ItemProperty. |
|
Output |
System.Management.Automation.PSCustomObject New-ItemProperty restituisce un oggetto personalizzato che contiene la nuova proprietà. |
Note
Il cmdlet New-ItemProperty è progettato per l'utilizzo di dati esposti da qualsiasi provider. Per elencare i provider disponibili nella sessione, digitare "Get-PSProvider". Per ulteriori informazioni, vedere about_Providers.
Esempio 1
C:\PS>new-itemproperty -path HKLM:\Software\MyCompany -name NoOfEmployees -value 822 C:\PS> 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 Descrizione ----------- Questo comando aggiunge una nuova voce del Registro di sistema, NoOfEmployees, alla chiave MyCompany dell'hive HKLM:\Software. Con il primo comando viene utilizzato il parametro Path per specificare il percorso della chiave del Registro di sistema MyCompany. Viene utilizzato il parametro Name per specificare un nome per la voce e il parametro Value per specificarne il valore. Nel secondo comando viene utilizzato il cmdlet Get-ItemProperty per vedere la nuova voce del Registro di sistema.
Esempio 2
C:\PS>get-item -path HKLM:\Software\MyCompany | new-Itemproperty -name NoOfLocations -value 3 Descrizione ----------- Con questo comando viene aggiunta una nuova voce del Registro di sistema a una chiave del Registro di sistema. Per specificare la chiave, viene utilizzato un operatore pipeline (|) per inviare un oggetto che rappresenta la chiave al cmdlet New-ItemProperty. Nella prima parte del comando viene utilizzato il cmdlet Get-Item per ottenere la chiave del Registro di sistema MyCompany. Con l'operatore pipeline (|) i risultati del comando vengono inviati al cmdlet New-ItemProperty che aggiunge la nuova voce del Registro di sistema, NoOfLocations, e il relativo valore 3 alla chiave MyCompany. Il funzionamento di questo comando è garantito dalla funzionalità di associazione dei parametri di Windows PowerShell mediante cui il percorso dell'oggetto RegistryKey restituito da Get-Item viene associato al parametro LiteralPath di New-ItemProperty. Per ulteriori informazioni, vedere about_Pipelines.
Vedere anche