mkdir

Module : Microsoft.PowerShell.Core
Crée un nouvel élément.

Syntaxe

mkdir <String> 
mkdir <String>] -Name <String> 

Description

Le cmdlet New-Item crée un nouvel é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 est utilisé pour créer des fichiers et des dossiers.Dans le registre, New-Item crée des clés et des entrées de registre.

New-Item peut également définir la valeur des éléments qu’il crée.Par exemple, lors de la création d’un nouveau fichier, New-Item peut ajouter un contenu initial au fichier.

Exemples

————————– EXEMPLE 1 ————————–

PS C:\>new-item -path . -name testfile1.txt -itemtype "file" -value "This is a text string."

Cette commande crée un fichier texte nommé testfile1.txt dans le répertoire actuel.Le point (.) dans la valeur du paramètre Path indique le répertoire actuel.Le texte cité qui suit le paramètre Value est ajouté au fichier comme contenu.

————————– EXEMPLE 2 ————————–

PS C:\>new-item -path c:\ -name logfiles -itemtype directory

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 du système de fichiers.

————————– EXEMPLE 3 ————————–

PS C:\>new-item -path $profile -itemtype file -force

Cette commande crée un profil Windows PowerShell dans le chemin qui est spécifié par la variable $profile.

Vous pouvez utiliser des profils pour personnaliser Windows PowerShell.$Profile est une variable automatique (intégrée) qui stocke le chemin et le nom de fichier du profil CurrentUser/CurrentHost.Par défaut, le profil n’existe pas, même si Windows PowerShell stocke un chemin et un nom de fichier pour lui.

Dans cette commande, la variable $profile représente le chemin d’accès au fichier.Le paramètre ItemType spécifie que la commande crée un fichier.Le paramètre Force vous permet de créer un fichier dans le chemin d’accès du profil, même si les répertoires du chemin n’existent pas (Windows PowerShell les crée).

Après avoir utilisé cette commande pour créer un profil, vous pouvez entrer des alias, des fonctions et des scripts dans le profil pour personnaliser votre shell.

Pour plus d’informations, voir about_Automatic_Variables et about_Profiles.

————————– EXEMPLE 4 ————————–

PS C:\>new-item -itemtype directory -path c:\ps-test\scripts

Cette commande crée un nouveau 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 du paramètre Path, au lieu d’être spécifié dans la valeur du paramètre Name.Comme l’indique la syntaxe, l’une ou l’autre forme de commande est valide.

————————– EXEMPLE 5 ————————–

PS C:\>new-item -itemtype file -path "c:\ps-test\test.txt", "c:\ps-test\Logs\test.log"

Cette commande utilise le cmdlet New-Item pour créer des fichiers dans deux répertoires différents.Comme le paramètre Path prend plusieurs chaînes, vous pouvez l’utiliser pour créer plusieurs éléments.

Paramètres requis

-Name

Spécifie le nom du nouvel élément.

Vous pouvez spécifier le nom du nouvel élément dans la valeur du paramètre Nom ou Chemin, et vous pouvez spécifier le chemin d’accès au nouvel élément dans la valeur du paramètre Nom ou Chemin.

Type : Chaîne
Position : Nommée
Valeur par défaut : Aucune
Accepter l’entrée du pipeline : True (ByPropertyName)
Accepter les caractères génériques : Faux
-Path

Spécifie le chemin vers 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 le paramètre Name, ou l’inclure dans le paramètre Path.

Type : Chaîne
Position : 1
Valeur par défaut : Aucune
Accepter l’entrée du pipeline : True (ByPropertyName)
Accepter les caractères génériques : Faux

Paramètres optionnels

-Confirm

Vous invite à confirmer avant d’exécuter la cmdlet.Vous invite à confirmer avant d’exécuter la cmdlet.

Type : SwitchParameter
Alias : cf
Position : Nommé
Valeur par défaut : Faux
Accepter l’entrée du pipeline : Faux
Accepter les caractères génériques : Faux
-Crédential

Spécifie un compte utilisateur qui a la permission d’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 que celui généré par le cmdlet Get-Credential.Si vous tapez un nom d’utilisateur, vous serez invité à saisir un mot de passe.

Ce paramètre n’est pas pris en charge par les fournisseurs installés avec Windows PowerShell

Type : PSCredential
Position : Nommé
Valeur par défaut : Aucune
Accepter l’entrée du pipeline : True (ByPropertyName)
Accepter les caractères génériques : False
-Force

Permet à la cmdlet de créer un élément qui écrit sur un élément existant en lecture seule.La mise en œuvre varie d’un fournisseur à l’autre.Pour plus d’informations, voir about_Providers.Même en utilisant le paramètre Force, la cmdlet ne peut pas passer outre les restrictions de sécurité.

Type : SwitchParameter
Position : Nommée
Valeur par défaut : Aucune
Accepter l’entrée du pipeline : Faux
Accepter les caractères génériques : Faux
-UseTransaction

Inclut la commande dans la transaction active.Ce paramètre n’est valable que lorsqu’une transaction est en cours.Pour plus d’informations, voir Inclut la commande dans la transaction active.Ce paramètre n’est valable que lorsqu’une transaction est en cours.Pour plus d’informations, voir

Type : SwitchParameter
Alias : usetx
Position : Nommé
Valeur par défaut : Faux
Accepter l’entrée du pipeline : Faux
Accepter les caractères génériques : False
-Value

Spécifie la valeur du nouvel élément.Vous pouvez également canaliser une valeur vers New-Item.

Type : Objet
Position : Nommée
Valeur par défaut : Aucune
Accepter l’entrée du pipeline : True (ByPropertyName, ByValue)
Accepter les caractères génériques : False
-WhatIf

Montre ce qui se passerait si la cmdlet s’exécute.La cmdlet n’est pas exécutée.

Type : SwitchParameter
Alias : wi
Position : Nommé
Valeur par défaut : Faux
Accepter l’entrée du pipeline : Faux
Accepter les caractères génériques : Faux

Entrées

System.Object

Vous pouvez canaliser une valeur pour le nouvel élément vers le cmdlet New-Item.

Sorties

System.Object

New-Item retourne l’élément qu’il crée.

Notes

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

  • Effacer-élément
  • Copier-élément
  • Obtenir-élément
  • Invoquer-élément
  • Déplacer-élément
  • Retirer-élément
  • Renommer-élément
  • Définir-élément
  • about_Providers

Laisser un commentaire

Votre adresse e-mail ne sera pas publiée.