New-Item în PowerShell

New-Item [-Path] <string[]> [-ItemType <string>] [-Value <Object>] [-Force]
New-Item [[-Path] <string[]>] -Name <string> [-ItemType <string>] [-Value <Object>] [-Force]

Ce face New-Item

New-Item creează un element nou în locația dată. În sistemul de fișiere, -ItemType poate fi File, Directory, SymbolicLink, Junction sau HardLink. Numele poate fi inclus în -Path sau dat separat cu -Name, relativ la -Path.

Cu -Value scrii conținut inițial într-un fișier nou. -Force creează și folderele lipsă din cale și suprascrie un fișier existent (îl golește sau îi pune noua valoare). Pentru un folder existent, -Force nu șterge nimic: întoarce folderul așa cum e.

Comanda întoarce obiectul creat, așa că în consolă vezi un tabel ca la Get-ChildItem; adaugă | Out-Null dacă nu vrei să apară. Alias: ni. Pentru linkuri simbolice pe Windows ai nevoie de drepturi de administrator sau de Developer Mode activat.

Parametri

Parametru	Descriere
-Path	Calea elementului nou (sau a folderului părinte, dacă folosești -Name). Implicit, locația curentă.
-Name	Numele elementului nou, creat în -Path.
-ItemType	Tipul: File, Directory, SymbolicLink, Junction, HardLink (alias -Type).
-Value	Conținutul inițial al fișierului sau ținta unui link (alias -Target).
-Force	Creează folderele lipsă din cale și suprascrie fișierele existente.
-WhatIf / -Confirm	Arată ce s-ar crea, respectiv cere confirmare.

Ce returnează

Obiectul creat: System.IO.FileInfo pentru fișiere, System.IO.DirectoryInfo pentru foldere.

Exemple

Exemplul 1: Creează un folder

Folderul facturi apare în C:\Proiecte, iar PowerShell afișează obiectul creat.

New-Item -Path C:\Proiecte -Name facturi -ItemType Directory

Ieșire în terminal

    Directory: C:\Proiecte

Mode                 LastWriteTime         Length Name
----                 -------------         ------ ----
d----         10/25/2026   9:05 AM                facturi

Exemplul 2: Fișier nou cu conținut inițial

-Value scrie textul în fișier; Length arată 16 octeți.

New-Item -Path .\note.txt -ItemType File -Value 'Ana Popescu,9.50'

Ieșire în terminal

    Directory: C:\Proiecte

Mode                 LastWriteTime         Length Name
----                 -------------         ------ ----
-a---         10/25/2026   9:07 AM             16 note.txt

Exemplul 3: Fișier într-un folder care încă nu există

-Force creează și folderele lipsă (rapoarte\2026) înainte de fișier.

New-Item -Path C:\Proiecte\rapoarte\2026\sumar.txt -ItemType File -Force

Ieșire în terminal

    Directory: C:\Proiecte\rapoarte\2026

Mode                 LastWriteTime         Length Name
----                 -------------         ------ ----
-a---         10/25/2026   9:10 AM              0 sumar.txt

Greșeli frecvente

• New-Item -Force pe un fișier care există îl suprascrie: conținutul vechi se pierde fără avertisment. Verifică întâi cu Test-Path.
• New-Item -ItemType Directory pe un folder care există deja dă eroare. În scripturi rulate de mai multe ori, verifică întâi cu Test-Path sau adaugă -Force (pentru foldere nu șterge nimic).
• Rezultatul afișat poate „polua” ieșirea unei funcții: o funcție care creează un folder și apoi întoarce o valoare va întoarce și obiectul folderului. Folosește New-Item ... | Out-Null sau $null = New-Item ....

Comenzi înrudite

• Test-Path: Verifică dacă o cale există și întoarce True sau False; poate cere să fie fișier sau folder și să fie mai nouă decât o dată.
• Set-Content: Scrie text într-un fișier și înlocuiește tot conținutul existent; creează fișierul dacă nu există.
• Remove-Item: Șterge fișiere și foldere (și alte elemente, ca chei de registry); ștergerea este definitivă, nu în Coșul de reciclare.
• Get-ChildItem: Listează fișierele și folderele dintr-o locație, opțional recursiv, filtrate după nume sau tip (echivalentul lui dir și ls).
• $PROFILE: Variabila $PROFILE conține calea scriptului care rulează la fiecare pornire a PowerShell, unde îți pui aliasurile și funcțiile.