New-Item

Új elemet hoz létre.

Syntax

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>]

Description

A New-Item parancsmag létrehoz egy új elemet, és beállítja annak értékét. A létrehozható elemtípusok az elem helyétől függenek. A fájlrendszerben New-Item például fájlokat és mappákat hoz létre. A beállításjegyzékben New-Item beállításkulcsokat és bejegyzéseket hoz létre.

New-Item A az általa létrehozott elemek értékét is beállíthatja. Ha például új fájlt hoz létre, New-Item hozzáadhatja a kezdeti tartalmat a fájlhoz.

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övegfájlt az aktuális könyvtárban. Az Elérési út paraméter értékeként megadott pont ('.') az aktuális könyvtárat jelöli. Az Érték paramétert követő idézett szöveg tartalomként lesz hozzáadva a fájlhoz.

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

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

Ez a parancs létrehoz egy "Logfiles" nevű könyvtárat a C: meghajtón. Az ItemType paraméter azt adja meg, hogy az új elem könyvtár, nem 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 változó által $profile megadott elérési úton.

Profilok használatával testre szabhatja a PowerShellt. $profile egy automatikus (beépített) változó, amely a "CurrentUser/CurrentHost" profil elérési útját és fájlnevét tárolja. Alapértelmezés szerint a profil nem létezik, annak ellenére, hogy a PowerShell egy elérési utat és egy fájlnevet tárol hozzá.

Ebben a parancsban a $profile változó a fájl elérési útját jelöli. Az ItemType paraméter azt adja meg, hogy a parancs létrehoz egy fájlt. A Force paraméterrel akkor is létrehozhat egy fájlt a profil elérési útján, ha az elérési út könyvtárai nem léteznek.

Miután létrehozott egy profilt, aliasokat, függvényeket és szkripteket adhat meg a profilban a rendszerhéj testreszabásához.

További információ: about_Automatic_Variables és about_Profiles.

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

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

Ez a példa létrehoz egy új szkriptkönyvtárat a "C:\PS-Test" könyvtárban.

Az új könyvtárelem ,,Szkriptek" neve szerepel az Elérési út paraméter értékében, nem pedig a Név értékben van megadva. Ahogy a szintaxis jelzi, bármelyik parancsűrlap é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 az elérési út több sztringet is használ, több elemet is létrehozhat.

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

6. példa: Fájlok létrehozása helyettesítő karakterek használatával több könyvtárban

A New-Item parancsmag támogatja a helyettesítő karaktereket az Elérési út paraméterben. Az alábbi parancs létrehoz egy temp.txt fájlt az Elérési út paraméterben megadott helyettesítő karakterek által megadott összes könyvtárban.

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

A Get-ChildItem parancsmag három könyvtárat jelenít meg a C:\Temp könyvtár alatt. Helyettesítő karakterek használatával a New-Item parancsmag létrehoz egy temp.txt fájlt az aktuális könyvtárban lévő összes könyvtárban. A New-Item parancsmag a létrehozott elemeket adja ki, amelyek az újonnan létrehozott fájlok elérési útjának ellenőrzésére Select-Object lesznek átirányítva.

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

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

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

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

Ebben a példában a Target az Érték paraméter aliasa. A szimbolikus hivatkozás célja lehet egy relatív elérési út. A PowerShell 6.2-s verzió előtt a célnak teljes elérési útnak kell lennie.

A PowerShell 7.1-től kezdve mostantól relatív elérési úttal hozhat létre symbolicLinket egy Windows-mappához.

8. példa: A -Force paraméter használata mappák újbóli létrehozásához

Ez a példa létrehoz egy mappát, benne egy fájllal. Ezután megkísérli létrehozni ugyanazt a mappát a következő használatával -Force: . Nem írja felül a mappát, hanem egyszerűen visszaadja a meglévő mappaobjektumot, és a fájl érintetlenül van létrehozva.

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

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

Ez a példa létrehoz egy értéket tartalmazó fájlt, majd újra létrehozza a fájlt a használatával -Force. Ez felülírja a meglévő fájlt, és a hossz tulajdonság által látható módon elveszíti a tartalmát.

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

Megjegyzés

New-Item Amikor a kapcsolóval használja a -Force beállításkulcsok létrehozását, a parancs ugyanúgy fog viselkedni, mint egy fájl felülírásakor. Ha a beállításkulcs már létezik, a rendszer felülírja a kulcsot, valamint az összes tulajdonságot és értéket egy üres beállításkulcsmal.

Paraméterek

-Confirm

Jóváhagyást kér a parancsmag futtatása előtt.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False

-Credential

Megjegyzés

Ezt a paramétert a PowerShell-lel telepített szolgáltatók nem támogatják. Ha egy másik felhasználót szeretne megszemélyesíteni, vagy a parancsmag futtatásakor emeli a hitelesítő adatait, használja Invoke-Commanda következőt: .

Type:PSCredential
Position:Named
Default value:Current user
Accept pipeline input:True
Accept wildcard characters:False

-Force

Kényszeríti ezt a parancsmagot egy olyan elem létrehozására, amely egy meglévő írásvédett elem fölé ír. A megvalósítás szolgáltatónként eltérő. A parancsmag még a Force paraméter használatával sem tudja felülbírálni a biztonsági korlátozásokat.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ItemType

Megadja az új elem szolgáltató által megadott típusát. A paraméter elérhető értékei a jelenleg használt szolgáltatótól függenek.

Ha a hely egy FileSystem meghajtón található, a következő értékek engedélyezettek:

  • Fájl
  • Címtár
  • SymbolicLink
  • Szinkronizációs pont
  • HardLink

Megjegyzés

A SymbolicLink windowsos típus létrehozásához rendszergazdai jogosultság szükséges. A fejlesztői mód engedélyezésével rendelkező Windows 10 (14972-ben vagy újabb buildben) azonban már nem szükséges emelt szintű jogosultságszint-emelt szintű szimbolikus hivatkozásokat létrehozni.

Certificate A meghajtókon a következő értékeket adhatja meg:

  • Tanúsítványszolgáltató
  • Tanúsítvány
  • Tárolás
  • StoreLocation

További információ: about_Providers.

Type:String
Aliases:Type
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-Name

Az új elem nevét adja meg. Az új elem nevét a Név vagy az Elérési út paraméter értékben adhatja meg, az új elem elérési útját pedig a Név vagy az Elérési út értékben. A Név paraméterrel átadott elemek nevei az Elérési út paraméter értékéhez viszonyítva jönnek létre.

Type:String
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-Path

Az új elem helyének elérési útját adja meg. Az elérési út elhagyásakor az alapértelmezett hely az aktuális hely. Megadhatja az új elem nevét a Név mezőben, vagy belefoglalhatja az elérési útra. A Név paraméterrel átadott elemek nevei az Elérési út paraméter értékéhez viszonyítva jönnek létre.

Ehhez a parancsmaghoz a Path paraméter a többi parancsmag LiterálPath paraméteréhez hasonlóan működik. A helyettesítő karaktereket a rendszer nem értelmezi. A rendszer minden karaktert átad a hely szolgáltatójának. Előfordulhat, hogy a szolgáltató nem támogatja az összes karaktert. Nem hozható létre például csillag (*) karaktert tartalmazó fájlnév.

Type:String[]
Position:0
Default value:Current location
Accept pipeline input:True
Accept wildcard characters:False

-Value

Az új elem értékét adja meg. Az értéket át is adhatja a parancsnak New-Item.

Type:Object
Aliases:Target
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Bemutatja, mi történne a parancsmag futtatásakor. A parancsmag nem fut.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False

Bevitelek

Object

Az új elem értékét erre a parancsmagra helyezheti.

Kimenetek

Object

Ez a parancsmag az általa létrehozott elemet adja vissza.

Jegyzetek

New-Item A úgy lett kialakítva, hogy bármely szolgáltató által közzétett adatokkal működjön együtt. A munkamenetben elérhető szolgáltatók listázásához írja be a következőt Get-PsProvider: . További információ: about_Providers.