New-Item

Sintaxa

New-Item <String> 

New-Item <String> 

New-Item <String>] -Name <String> 

Descriere

Codletul New-Item creează un nou element și îi stabilește valoarea. Tipurile de elemente care pot fi create depind de locația elementului. De exemplu, în sistemul de fișiere, New-Item creează fișiere șifoldere. În registru, New-Item creează chei și intrări de registru.

New-Item poate, de asemenea, seta valoarea elementelor pe care le creează. De exemplu, când creează un fișier nou, New-Item poate adăuga conținutul inițial al fișierului.

Exemple

Exemplu 1: Crearea unui fișier în directorul curent

Această comandă creează un fișier text care se numește „testfile1.txt” în directorul curent. Punctul (‘.’) din valoarea parametrului Path indică directorul curent. Textul citat care urmează după parametrul Value este adăugat la fișier ca și conținut.

New-Item -Path . -Name "testfile1.txt" -ItemType "file" -Value "This is a text string."

Exemplu 2: Crearea unui director

Această comandă creează un director numit „Logfiles” în unitatea C:. Parametrul ItemTypeprecizează că noul element este un director, nu un fișier sau un alt obiect al sistemului de fișiere.

New-Item -Path "c:\" -Name "logfiles" -ItemType "directory"

Exemplu 3: Crearea unui profil

Această comandă creează un profil PowerShell în calea care este specificată de variabila $profile.

Puteți utiliza profiluri pentru a personaliza PowerShell. $profile este o variabilă automată (încorporată) care stochează calea și numele de fișier al profilului „CurrentUser/CurrentHost”. În mod implicit, profilul nu există, chiar dacă PowerShell stochează o cale și un nume de fișier pentru acesta.

În această comandă, variabila $profile reprezintă calea fișierului. Parametrul ItemTypeprecizează că comanda creează un fișier. Parametrul Force vă permite să creați un fișier în caleaprofilului, chiar și atunci când directoarele din cale nu există.

După ce creați un profil, puteți introduce aliasuri, funcții și scripturi în profil pentru a vă personaliza shell-ul.

Pentru mai multe informații, consultați despre_Automatic_Variablesși despre_Profile.

New-Item -Path $profile -ItemType "file" -Force

Exemplu 4: Crearea unui director într-un alt director

Acest exemplu creează un nou director Scripts în directorul „C:\PS-Test”.

Numele noului element de director, „Scripts”, este inclus în valoarea parametrului Path,în loc să fie specificat în valoarea lui Name. După cum indică sintaxa, oricare dintre formele de comandăeste valabilă.

New-Item -ItemType "directory" -Path "c:\ps-test\scripts"

Exemplu 5: Crearea mai multor fișiere

Acest exemplu creează fișiere în două directoare diferite. Deoarece Path acceptă mai multe șiruri de caractere,îl puteți utiliza pentru a crea mai multe elemente.

New-Item -ItemType "file" -Path "c:\ps-test\test.txt", "c:\ps-test\Logs\test.log"

Exemplu 6: Utilizați caractere joker pentru a crea fișiere în mai multe directoare

Commandantul New-Item acceptă caractere joker în parametrul Path. Următoarea comandă creează un fișiertemp.txt în toate directoarele specificate de wildcards în parametrul Path.

Get-ChildItem -Path C:\Temp\Directory: C:\TempMode LastWriteTime Length Name---- ------------- ------ ----d----- 5/15/2019 6:45 AM 1 Oned----- 5/15/2019 6:45 AM 1 Twod----- 5/15/2019 6:45 AM 1 ThreeNew-Item -Path * -Name temp.txt -ItemType File | Select-Object FullNameFullName--------C:\Temp\One\temp.txtC:\Temp\Three\temp.txtC:\Temp\Two\temp.txt

Commandă Get-ChildItemCommandă Get-ChildItem arată trei directoare sub directorul C:\Temp. Utilizând caractere joker, cmdlet-ul New-Item creează un fișier temp.txt în toate directoarele de sub directorul curent. cmdlet-ul New-Item emite elementele pe care le-ați creat, care este direcționat către Select-Objectpentru a verifica căile de acces ale fișierelor nou create.

Exemplu 7: Crearea unei legături simbolice către un fișier sau un dosar

Acest exemplu creează o legătură simbolică către fișierul Notice.txt din folderul curent.

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

În acest exemplu, Target este un alias pentru parametrul Value. Ținta legăturii simbolicepoate fi o cale relativă. Înainte de PowerShell v6.2, ținta trebuie să fie o cale complet calificată.

Începând cu PowerShell 7.1, puteți crea acum o legătură simbolică către un dosar în Windows folosind o cale relativă.

Exemplul 8: Utilizați parametrul -Force pentru a încerca să recreați folderele

Acest exemplu creează un dosar cu un fișier în interior. Apoi, încearcă să creeze același dosar folosind-Force. Nu va suprascrie dosarul, ci va returna pur și simplu obiectul folder existent cu fișierul creat intact.

PS> New-Item -Path .\TestFolder -ItemType DirectoryPS> New-Item -Path .\TestFolder\TestFile.txt -ItemType FilePS> New-Item -Path .\TestFolder -ItemType Directory -Force Directory: C:\Mode LastWriteTime Length Name---- ------------- ------ ----d----- 5/1/2020 8:03 AM TestFolderPS> Get-ChildItem .\TestFolder\ Directory: C:\TestFolderMode LastWriteTime Length Name---- ------------- ------ -----a---- 5/1/2020 8:03 AM 0 TestFile.txt

Exemplu 9: Utilizați parametrul -Force pentru a suprascrie fișierele existente

Acest exemplu creează un fișier cu o valoare și apoi recreează fișierul utilizând -Force. Acest lucru suprascrie Fișierul existent și acesta își va pierde conținutul, după cum se poate vedea prin proprietatea length

PS> New-Item ./TestFile.txt -ItemType File -Value 'This is just a test file' Directory: C:\Source\TestMode LastWriteTime Length Name---- ------------- ------ -----a---- 5/1/2020 8:32 AM 24 TestFile.txtNew-Item ./TestFile.txt -ItemType File -Force Directory: C:\Source\TestMode LastWriteTime Length Name---- ------------- ------ -----a---- 5/1/2020 8:32 AM 0 TestFile.txt

Parametri