New-Item

Syntax

New-Item <String> 

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

Description

A New-Item cmdlet új elemet hoz létre és beállítja annak értékét. A létrehozható elemek típusaiaz elem helyétől függnek. Például a fájlrendszerben a New-Item fájlokat és mappákat hoz létre. A rendszerleíró adatbázisban a New-Item rendszerleíró kulcsokat és bejegyzéseket hoz létre.

New-Item a létrehozott elemek értékét is beállíthatja. Például egy újfájl létrehozásakor a New-Item hozzáadhatja a fájl kezdeti tartalmát.

Példák

1. példa: Fájl létrehozása az aktuális könyvtárban

Ez a parancs létrehoz egy “testfile1.txt” nevű szöveges fájlt az aktuális könyvtárban. A Path paraméter értékében a pont(‘.’) az aktuális könyvtárat jelzi. A Value paramétert követő idézőjeles szöveg tartalomként hozzáadódik a fájlhoz.

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

Példa 2: Könyvtár létrehozása

Ez a parancs létrehoz egy “Logfiles” nevű könyvtárat a C: meghajtóban. Az ItemType paramétermeghatározza, hogy az új elem könyvtár, nem pedig fájl vagy más fájlrendszer-objektum.

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

3. példa: Profil létrehozása

Ez a parancs létrehoz egy PowerShell-profilt a $profile változó által megadott elérési útvonalon.

A PowerShell testreszabásához profilokat használhat. A $profile egy automatikus (beépített) változó, amelytárolja a “CurrentUser/CurrentHost” profil elérési útját és fájlnevét. Alapértelmezés szerint a profil nem létezik, bár a PowerShell tárolja a profil elérési útvonalát és fájlnevét.

Ebben a parancsban a $profile változó a fájl elérési útvonalát jelöli. Az ItemType paramétermeghatározza, hogy a parancs egy fájlt hoz létre. A Force paraméter lehetővé teszi egy fájl létrehozását aprofil elérési útvonalában, még akkor is, ha az elérési útvonalban lévő könyvtárak nem léteznek.

A profil létrehozása után aliasokat, függvényeket és szkripteket adhat meg a profilban a héj testreszabásához.

További információkért lásd: about_Automatic_Variablesés about_Profiles.

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

4. példa: Könyvtár létrehozása egy másik könyvtárban

Ez a példa egy új Scripts könyvtárat hoz létre a “C:\PS-Test” könyvtárban.

Az új könyvtárelem “Scripts” neve szerepel a Path paraméter értékében,ahelyett, hogy a Name értékében lenne megadva. Ahogy a szintaxis jelzi, mindkét parancsforma érvényes.

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

5. példa: Több fájl létrehozása

Ez a példa két különböző könyvtárban hoz létre fájlokat. Mivel a Path több karakterláncot is elfogad,több elem létrehozására is használható.

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

6. példa: Helyőrző karakterek használata fájlok létrehozásához több könyvtárban

A New-Item cmdlet támogatja a helyőrző karaktereket a Path paraméterben. A következő parancs létrehoz egytemp.txt fájlt a Path paraméterben megadott vadkeresztek által meghatározott összes könyvtárban.

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

A Get-ChildItem cmdlet három könyvtárat mutat a C:\Temp könyvtár alatt. A New-Item cmdlet a jokerek használatával létrehoz egy temp.txt fájlt az aktuáliskönyvtár alatti összes könyvtárban. A New-Item cmdlet kiadja a létrehozott elemeket, amelyeket a Select-Object-be továbbít, hogy ellenőrizze az újonnan létrehozott fájlok elérési útvonalait.

7. példa: Szimbolikus hivatkozás létrehozása egy fájlhoz vagy mappához

Ez a példa szimbolikus hivatkozást hoz létre a Notice.txt fájlhoz az aktuális mappában.

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

Ebben a példában a Target a Value paraméter álneve. A szimbolikus hivatkozás célja lehet egy relatív elérési útvonal. A PowerShell v6.2 előtt a célnak egy teljesen minősített elérési útvonalnak kell lennie.

A PowerShell 7.1-től kezdődően most már létrehozhat egy mappára mutató szimbolikus linket a Windowson relatív elérési útvonal használatával.

8. példa: A -Force paraméter használatával megpróbálhat mappákat újra létrehozni

Ez a példa létrehoz egy mappát, benne egy fájllal. Ezután megpróbálja létrehozni ugyanezt a mappát a-Force használatával. Nem írja felül a mappát, hanem egyszerűen visszaadja a meglévő mappaobjektumot a létrehozott fájl érintetlenül hagyásával.

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

9. példa: A -Force paraméter használata meglévő fájlok felülírására

Ez a példa létrehoz egy fájlt egy értékkel, majd a -Force használatával újra létrehozza a fájlt. Ez felülírjaA meglévő fájlt, és elveszíti a tartalmát, amint az a hossz tulajdonságból látható

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

Paraméterek