New-ItemProperty

Syntaxe

Path (Par défaut)

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

LiteralPath

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

Description

Exemples

Exemple 1 : Ajouter une 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 : 822

Exemple 2 : Ajouter une entrée de Registre à une clé

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

Exemple 3 : Créer une valeur MultiString dans le Registre à l’aide d’un 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.HereString

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

Exemple 4 : Créer une valeur MultiString dans le Registre à l’aide d’un tableau

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

a

Paramètres

-Confirm

Vous invite à confirmer avant d’exécuter l’applet de commande.

Propriétés du paramètre

Jeux de paramètres

-Credential

Spécifie un compte d’utilisateur autorisé à effectuer 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 de commande Get-Credential. Si vous tapez un nom d’utilisateur, vous êtes invité à entrer un mot de passe.

Propriétés du paramètre

Jeux de paramètres

-Exclude

Spécifie, en tant que tableau de chaînes, un élément ou des éléments que cette applet de commande exclut dans l’opération. La valeur de ce paramètre qualifie le paramètre Path. Entrez un élément de chemin ou un modèle, tel que *.txt. Les caractères génériques sont autorisés. Le paramètre Exclure est efficace uniquement lorsque la commande inclut le contenu d’un élément, tel que C:\Windows\*, où le caractère générique spécifie le contenu du répertoire C:\Windows.

Propriétés du paramètre

Jeux de paramètres

-Filter

Spécifie un filtre pour qualifier le paramètre Path. Le fournisseur FileSystem est le seul fournisseur PowerShell installé qui prend en charge l’utilisation de filtres. Vous pouvez trouver la syntaxe du langage de filtre FileSystem dans about_Wildcards. 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.

Propriétés du paramètre

Jeux de paramètres

-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 varie du fournisseur au fournisseur. Pour plus d’informations, voir about_Providers.

Propriétés du paramètre

Jeux de paramètres

-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 de chemin ou un modèle, tel que *.txt. Les caractères génériques sont autorisés. Le paramètre Include n’est effectif que lorsque la commande inclut le contenu d’un élément, tel que C:\Windows\*, où le caractère générique spécifie le contenu du répertoire C:\Windows.

Propriétés du paramètre

Jeux de paramètres

-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 la section sur les règles de citation.

Propriétés du paramètre

Jeux de paramètres

-Name

Spécifie un nom pour 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.

Propriétés du paramètre

Jeux de paramètres

-Path

Spécifie le chemin d’accès de l’élément. Les caractères génériques sont autorisés. Ce paramètre identifie l’élément auquel cette applet de commande ajoute la nouvelle propriété.

Propriétés du paramètre

Jeux de paramètres

-PropertyType

Spécifie le type de propriété ajouté par cette applet de commande. Les valeurs acceptables pour ce paramètre sont les suivantes :

• 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 un caractère nul qui contient des références non développées aux variables d’environnement, celles-ci étant 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 quelle forme. Utilisé pour les valeurs REG_BINARY.
• DWord: spécifie un nombre binaire 32 bits. Utilisé pour les valeurs REG_DWORD.
• MultiString: Spécifie un tableau de chaînes se terminant chacune par un caractère nul, et le tableau est terminé par deux caractères nuls. 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.

Propriétés du paramètre

Jeux de paramètres

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

Propriétés du paramètre

Jeux de paramètres

-WhatIf

Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande ne s’exécute pas.

Propriétés du paramètre

Jeux de paramètres

CommonParameters

Entrées

None

Sorties

PSCustomObject

Notes

Liens associés

• Clear-ItemProperty
• Copy-ItemProperty
• Get-ItemProperty
• Move-ItemProperty
• Remove-ItemProperty
• Rename-ItemProperty
• Set-ItemProperty
• À propos des fournisseurs