New-Item
Crée un élément.
Syntaxe
New-Item
[-Path] <String[]>
[-ItemType <String>]
[-Value <Object>]
[-Force]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[-UseTransaction]
[<CommonParameters>]New-Item
[[-Path] <String[]>]
-Name <String>
[-ItemType <String>]
[-Value <Object>]
[-Force]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[-UseTransaction]
[<CommonParameters>]Description
L’applet de commande New-Item crée un élément et définit sa valeur. Les types d’éléments qui peuvent être créés dépendent de l’emplacement de l’élément. Par exemple, dans le système de fichiers, New-Item crée des fichiers et des dossiers. Dans le Registre, New-Item crée des clés et des entrées de Registre.
New-Item pouvez également définir la valeur des éléments qu’il crée. Par exemple, lorsqu’il crée un fichier, New-Item pouvez ajouter du contenu initial au fichier.
Exemples
Exemple 1 : Créer un fichier dans le répertoire actif
Cette commande crée un fichier texte nommé «testfile1.txt» dans le répertoire actif. Le point ('.') dans la valeur du paramètre Path indique le répertoire actif. Le texte entre guillemets qui suit le paramètre Value est ajouté au fichier en tant que contenu.
New-Item -Path . -Name "testfile1.txt" -ItemType "file" -Value "This is a text string."Exemple 2 : Créer un répertoire
Cette commande crée un répertoire nommé « Logfiles » dans le lecteur C:. Le paramètre ItemType spécifie que le nouvel élément est un répertoire, et non un fichier ou un autre objet de système de fichiers.
New-Item -Path "c:\" -Name "logfiles" -ItemType "directory"Exemple 3 : Créer un profil
Cette commande crée un profil PowerShell dans le chemin d’accès spécifié par la variable $profile.
Vous pouvez utiliser des profils pour personnaliser PowerShell.
$profile est une variable automatique (intégrée) qui stocke le chemin d’accès et le nom de fichier du profil « CurrentUser/CurrentHost ». Par défaut, le profil n’existe pas, même si PowerShell stocke un chemin d’accès et un nom de fichier pour celui-ci.
Dans cette commande, la variable $profile représente le chemin d’accès du fichier.
paramètre ItemType spécifie que la commande crée un fichier. Le paramètre Forcer vous permet de créer un fichier dans le chemin du profil, même lorsque les répertoires du chemin d’accès n’existent pas.
Après avoir créé un profil, vous pouvez entrer des alias, des fonctions et des scripts dans le profil pour personnaliser votre interpréteur de commandes.
Pour plus d’informations, consultez about_Automatic_Variables et about_Profiles.
New-Item -Path $profile -ItemType "file" -ForceNote
Lorsque vous créez un fichier à l’aide de cette méthode, le fichier résultant est encodé en UTF-8 sans marque d’ordre d’octet (BOM).
Exemple 4 : Créer un répertoire dans un autre répertoire
Cet exemple crée un répertoire Scripts dans le répertoire « C :\PS-Test ».
Le nom du nouvel élément de répertoire, « Scripts », est inclus dans la valeur de paramètre Path, au lieu d’être spécifié dans la valeur de Name. Comme indiqué par la syntaxe, l’un ou l’autre formulaire de commande est valide.
New-Item -ItemType "directory" -Path "c:\ps-test\scripts"Exemple 5 : Créer plusieurs fichiers
Cet exemple crée des fichiers dans deux répertoires différents. Étant donné que Path accepte plusieurs chaînes, vous pouvez l’utiliser pour créer plusieurs éléments.
New-Item -ItemType "file" -Path "c:\ps-test\test.txt", "c:\ps-test\Logs\test.log"Paramètres
-Confirm
Vous invite à confirmer 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
Note
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 |
-Force
Force cette applet de commande à créer un élément qui écrit sur un élément en lecture seule existant. L’implémentation varie du fournisseur au fournisseur. Pour plus d’informations, consultez about_Providers. Même à l’aide du paramètre Forcer, l’applet de commande ne peut pas remplacer les restrictions de sécurité.
| Type: | SwitchParameter |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-ItemType
Spécifie le type spécifié par le fournisseur du nouvel élément. Les valeurs disponibles de ce paramètre dépendent du fournisseur actuel que vous utilisez.
Si votre emplacement se trouve dans un lecteur FileSystem, les valeurs suivantes sont autorisées :
- Lime
- Répertoire
- SymbolLink
- Jonction
- HardLink
Lorsque vous créez un fichier à l’aide de cette méthode, le fichier résultant est encodé en UTF-8 sans marque d’ordre d’octet (BOM).
Dans un lecteur Certificate, voici les valeurs que vous pouvez spécifier :
- Fournisseur de certificats
- Certificat
- Boutique
- StoreLocation
Pour plus d’informations, consultez about_Providers.
| 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 |
-Name
Spécifie le nom du nouvel élément.
Vous pouvez spécifier le nom du nouvel élément dans l' Nom
| Type: | String |
| Position: | Named |
| 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’emplacement du nouvel élément. Les caractères génériques sont autorisés.
Vous pouvez spécifier le nom du nouvel élément dans Nom, ou l’inclure dans Chemin d’accès.
| Type: | String[] |
| Position: | 0 |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | True |
-UseTransaction
Inclut la commande dans la transaction active. Ce paramètre est valide uniquement lorsqu’une transaction est en cours. 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 du nouvel élément. Vous pouvez également diriger une valeur vers New-Item.
| Type: | Object |
| Alias: | Target |
| 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
Affiche ce qui se passerait si l’applet de commande s’exécute. 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
Vous pouvez diriger une valeur pour le nouvel élément vers cette applet de commande.
Sorties
Cette applet de commande retourne l’élément qu’il crée.
Notes
New-Item 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.