New-Item

New-Item
    [-Path] <String[]>
    [-ItemType <String>]
    [-Value <Object>]
    [-Force]
    [-Credential <PSCredential>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

New-Item
    [[-Path] <String[]>]
    -Name <String>
    [-ItemType <String>]
    [-Value <Object>]
    [-Force]
    [-Credential <PSCredential>]
    [-WhatIf]
    [-Confirm]
    [<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"

L’applet de commande New-Item prend en charge les caractères génériques dans le paramètre Path. La commande suivante crée un fichier temp.txt dans tous les répertoires spécifiés par les caractères génériques dans le paramètre Path.

Get-ChildItem -Path C:\Temp\

    Directory:  C:\Temp

Mode                LastWriteTime     Length Name
----                -------------     ------ ----
d-----        5/15/2019   6:45 AM        1   One
d-----        5/15/2019   6:45 AM        1   Two
d-----        5/15/2019   6:45 AM        1   Three

New-Item -Path C:\Temp\* -Name temp.txt -ItemType File | Select-Object FullName

FullName
--------
C:\Temp\One\temp.txt
C:\Temp\Three\temp.txt
C:\Temp\Two\temp.txt

L’applet de commande Get-ChildItem affiche trois répertoires sous le répertoire C:\Temp. L’utilisation de caractères génériques de l’applet de commande New-Item crée un fichier temp.txt dans tous les répertoires sous le répertoire actif. L’applet de commande New-Item génère les éléments que vous avez créés, qui sont redirigés vers Select-Object pour vérifier les chemins des fichiers nouvellement créés.

Cet exemple crée un lien symbolique vers le fichier Notice.txt dans le dossier actif.

$link = New-Item -ItemType SymbolicLink -Path .\link -Target .\Notice.txt
$link | Select-Object LinkType, Target

LinkType     Target
--------     ------
SymbolicLink {.\Notice.txt}

Dans cet exemple, cible est un alias pour le paramètre Value. La cible du lien symbolique peut être un chemin relatif. Avant PowerShell v6.2, la cible doit être un chemin complet.

À compter de PowerShell 7.1, vous pouvez maintenant créer un SymbolLink à un dossier sur Windows à l’aide d’un chemin relatif.

Cet exemple crée un dossier avec un fichier à l’intérieur. Ensuite, tente de créer le même dossier à l’aide de -Force. Il ne remplace pas le dossier, mais retourne simplement l’objet dossier existant avec le fichier créé intact.

PS> New-Item -Path .\TestFolder -ItemType Directory
PS> New-Item -Path .\TestFolder\TestFile.txt -ItemType File

PS> New-Item -Path .\TestFolder -ItemType Directory -Force

    Directory: C:\
Mode                LastWriteTime         Length Name
----                -------------         ------ ----
d-----         5/1/2020   8:03 AM                TestFolder

PS> Get-ChildItem .\TestFolder\

    Directory: C:\TestFolder
Mode                LastWriteTime         Length Name
----                -------------         ------ ----
-a----         5/1/2020   8:03 AM              0 TestFile.txt

Cet exemple crée un fichier avec une valeur, puis recrée le fichier à l’aide de -Force. Cela écrase le fichier existant et il perdra son contenu, comme vous pouvez le voir par la propriété length

PS> New-Item ./TestFile.txt -ItemType File -Value 'This is just a test file'

    Directory: C:\Source\Test
Mode                LastWriteTime         Length Name
----                -------------         ------ ----
-a----         5/1/2020   8:32 AM             24 TestFile.txt

New-Item ./TestFile.txt -ItemType File -Force

    Directory: C:\Source\Test
Mode                LastWriteTime         Length Name
----                -------------         ------ ----
-a----         5/1/2020   8:32 AM              0 TestFile.txt

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.