New-ItemProperty
Crée une propriété pour un élément et définit sa valeur.
Syntaxe
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>] Description
L’applet New-ItemProperty de commande crée une propriété pour un élément spécifié et définit sa valeur.
En général, cette applet de commande permet de créer des valeurs de Registre, car les valeurs de Registre sont les propriétés d’un élément de clé de Registre.
Cette applet de commande n’ajoute pas de propriétés à un objet.
- Pour ajouter une propriété à une instance d’un objet, utilisez l’applet
Add-Memberde commande. - Pour ajouter une propriété à tous les objets d’un type particulier, modifiez le fichier Types.ps1xml.
Exemples
Exemple 1 : Ajouter une entrée de Registre
Cette commande ajoute une nouvelle entrée de Registre, NoOfEmployeesà la MyCompany clé du HKLM:\Software hive.
La première commande utilise le paramètre Path pour spécifier le chemin d’accès de la clé de MyCompany Registre.
Il utilise le paramètre Name pour spécifier un nom pour l’entrée et le paramètre Value pour spécifier sa valeur.
La deuxième commande utilise l’applet Get-ItemProperty de commande pour afficher la nouvelle entrée de Registre.
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 : 822Exemple 2 : Ajouter une entrée de Registre à une clé
Cette commande ajoute une nouvelle entrée de Registre à une clé de Registre. Pour spécifier la clé, elle utilise un opérateur de pipeline (|) pour envoyer un objet qui représente la clé à New-ItemProperty.
La première partie de la commande utilise l’applet Get-Item de commande pour obtenir la clé de MyCompany Registre. L’opérateur de pipeline envoie les résultats de la commande à New-ItemProperty, qui ajoute la nouvelle entrée de Registre (NoOfLocations) et sa valeur (3), à la MyCompany clé.
Get-Item -Path "HKLM:\Software\MyCompany" | New-ItemProperty -Name NoOfLocations -Value 3Cette commande fonctionne, car la fonctionnalité de liaison de paramètres de Windows PowerShell associe le chemin d’accès de l’objet RegistryKey qui Get-Item retourne avec le paramètre LiteralPath de New-ItemProperty. Pour plus d’informations, consultez about_Pipelines.
Exemple 3 : Créer une valeur MultiString dans le Registre à l’aide d’une chaîne ici
Cet exemple crée une MultiString valeur à l’aide d’une chaîne ici.
$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" stringsExemple 4 : Créer une valeur MultiString dans le Registre à l’aide d’un tableau
L’exemple montre comment utiliser un tableau de valeurs pour créer la MultiString valeur.
$newValue = New-ItemProperty -Path "HKLM:\SOFTWARE\ContosoCompany\" -Name 'MultiString' -PropertyType MultiString -Value ('a','b','c')
$newValue.multistring[0]
aParamètres
-Confirm
Vous demande une confirmation avant d’exécuter l’applet de commande.
| Type: | SwitchParameter |
| Alias: | cf |
| Position: | Named |
| Valeur par défaut: | False |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-Credential
Spécifie un compte d’utilisateur qui a l’autorisation d’exécuter cette action. La valeur par défaut est l’utilisateur actuel.
Tapez un nom d’utilisateur, tel que User01 ou Domain01\User01, ou entrez un objet PSCredential , tel qu’un objet généré par l’applet Get-Credential de commande. Si vous tapez un nom d’utilisateur, vous êtes invité à entrer un mot de passe.
Remarque
Ce paramètre n’est pas pris en charge par les fournisseurs installés avec PowerShell. Pour emprunter l’identité d’un autre utilisateur ou élever vos informations d’identification lors de l’exécution de cette applet de commande, utilisez Invoke-Command.
| Type: | PSCredential |
| Position: | Named |
| Valeur par défaut: | Current user |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | False |
-Exclude
Spécifie, en tant que tableau de chaînes, une propriété ou une propriété que cette applet de commande exclut de l’opération.
La valeur de ce paramètre qualifie le paramètre Path .
Entrez un élément ou un modèle de chemin d’accès, tel que *.txt.
Les caractères génériques sont autorisés.
| Type: | String[] |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-Filter
Spécifie un filtre dans le format ou la langue du fournisseur. La valeur de ce paramètre qualifie le paramètre Path .
La syntaxe du filtre, y compris l’utilisation de caractères génériques, dépend du fournisseur. Les filtres sont plus efficaces que d’autres paramètres, car le fournisseur les applique lorsque l’applet de commande obtient les objets plutôt que de filtrer les objets après leur récupération.
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-Force
Force l’applet de commande à créer une propriété sur un objet qui ne peut pas être accessible autrement par l’utilisateur. L'implémentation est différente d'un fournisseur à l'autre. Pour plus d’informations, consultez about_Providers.
| Type: | SwitchParameter |
| Position: | Named |
| Valeur par défaut: | False |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-Include
Spécifie, sous la forme d’un tableau de chaînes, un élément ou des éléments inclus dans l’opération. La valeur de ce paramètre qualifie le paramètre Path . Entrez un élément ou un modèle de chemin d’accès, tel que *.txt. Les caractères génériques sont autorisés. Le paramètre Include est efficace uniquement lorsque la commande inclut le contenu d’un élément, par C:\Windows\*exemple, où le caractère générique spécifie le contenu du C:\Windows répertoire.
| Type: | String[] |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-LiteralPath
Spécifie un chemin d’accès à un ou plusieurs emplacements. La valeur de LiteralPath est utilisée exactement comme elle est typée. Aucun caractère n’est interprété en tant que caractère générique. Si le chemin inclut des caractères d’échappement, placez-le entre guillemets simples ('). Les guillemets simples indiquent à PowerShell de ne pas interpréter de caractères comme séquences d’échappement.
Pour plus d’informations, consultez about_Quoting_Rules.
| Type: | String[] |
| Alias: | PSPath |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | False |
-Name
Spécifie le nom de la nouvelle propriété. Si la propriété est une entrée de Registre, ce paramètre spécifie le nom de l’entrée.
| Type: | String |
| Alias: | PSProperty |
| Position: | 1 |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | False |
-Path
Spécifie le chemin d’accès de l’élément. Ce paramètre identifie l’élément auquel cette applet de commande ajoute la nouvelle propriété.
| Type: | String[] |
| Position: | 0 |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-PropertyType
Spécifie le type de propriété ajouté par cette applet de commande. Les valeurs valides pour ce paramètre sont :
String: spécifie une chaîne terminée par null. Utilisé pour les valeurs REG_SZ .ExpandString: spécifie une chaîne terminée par null qui contient des références non expirées aux variables d’environnement qui sont développées lorsque la valeur est récupérée. Utilisé pour les valeurs REG_EXPAND_SZ .Binary: spécifie les données binaires sous n’importe quel formulaire. Utilisé pour les valeurs REG_BINARY .DWord: spécifie un nombre binaire 32 bits. Utilisé pour REG_DWORD valeurs.MultiString: spécifie un tableau de chaînes terminées par null terminées par deux caractères Null. Utilisé pour les valeurs REG_MULTI_SZ .Qword: spécifie un nombre binaire 64 bits. Utilisé pour les valeurs REG_QWORD .Unknown: indique un type de données de Registre non pris en charge, tel que des valeurs REG_RESOURCE_LIST .
| Type: | String |
| Alias: | Type |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | False |
-UseTransaction
Inclut la commande dans la transaction active. Ce paramètre est uniquement valide au cours d’une transaction. Pour plus d’informations, consultez about_Transactions.
| Type: | SwitchParameter |
| Alias: | usetx |
| Position: | Named |
| Valeur par défaut: | False |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-Value
Spécifie la valeur de la propriété. Si la propriété est une entrée de Registre, ce paramètre spécifie la valeur de l’entrée.
| Type: | Object |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | False |
-WhatIf
Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.
| Type: | SwitchParameter |
| Alias: | wi |
| Position: | Named |
| Valeur par défaut: | False |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
Entrées
None
Vous ne pouvez pas diriger les objets vers cette applet de commande.
Sorties
Cette applet de commande retourne un objet personnalisé représentant la nouvelle propriété.
Notes
New-ItemProperty est conçu pour fonctionner avec les données exposées par n’importe quel fournisseur. Pour répertorier les fournisseurs disponibles dans votre session, tapez Get-PSProvider. Pour plus d’informations, consultez about_Providers.
