New-Item

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

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.

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

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"

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" -Force

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"

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"

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

Vous pouvez diriger une valeur pour le nouvel élément vers cette applet de commande.

Cette applet de commande retourne l’élément qu’il crée.

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, voir about_Providers.