New-Item

Modul:

Microsoft.PowerShell.Management Module

Új elemet hoz létre.

Syntax

pathSet (Alapértelmezett)

New-Item
    [-Path] <String[]>
    [-ItemType <String>]
    [-Value <Object>]
    [-Force]
    [-Credential <PSCredential>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

nameSet

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ó elemek típusai az elem helyétől függenek. A fájlrendszerben például New-Item 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 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áadhat 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. A Elérési út paraméter értéke ('.') az aktuális könyvtárat jelzi. A Value 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 határozza meg, hogy az új elem könyvtár, nem fájl vagy más fájlrendszerobjektum.

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 ú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.

Ebben a parancsban a $profile változó a fájl elérési útját jelöli. ItemType paraméter azt határozza 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 másik könyvtárban

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

A "Szkriptek" nevű új könyvtárelem neve szerepel a Elérési út paraméter értékében, ahelyett, hogy az Névértékében szerepelne. A szintaxis szerint 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 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: Helyettesítő karakterek használata fájlok több könyvtárban való létrehozásához

A New-Item parancsmag támogatja a helyettesítő karaktereket a Elérési út paraméterben. Az alábbi parancs létrehoz egy temp.txt fájlt a Elérési út paraméterben 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ár összes könyvtárában. A New-Item parancsmag a létrehozott elemeket adja ki, amelyet a rendszer Select-Object az újonnan létrehozott fájlok elérési útjainak ellenőrzéséhez.

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

Ez a példa 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 Cél a É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 létrehozhat egy SymbolicLink egy Windows-mappába egy relatív elérési út használatával.

8. példa: A -Force paraméter használatával próbálja meg újból létrehozni a mappákat

Ez a példa létrehoz egy mappát, benne egy fájllal. Ezután megpróbálja létrehozni ugyanazt a mappát -Forcehasználatával. 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: Meglévő fájlok felülírása a -Force paraméter használatával

Ez a példa létrehoz egy értéket tartalmazó fájlt, majd újra létrehozza a fájlt a -Forcehasználatával. Ez felülírja a meglévő fájlt, és elveszíti a tartalmát, amint azt a length tulajdonság mutatja

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:

Ha a New-Item a -Force kapcsolóval használja a beállításkulcsok létrehozásához, 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 kulcs és az összes tulajdonság és érték felülíródik egy üres beállításkulcsmal.

Paraméterek

-Confirm

Megerősítést kér a parancsmag futtatása előtt.

Paramétertulajdonságok

Típus:	SwitchParameter
Alapértelmezett érték:	False
Támogatja a helyettesítő karaktereket:	False
DontShow:	False
Aliasok:	Cf

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	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 a Invoke-Command.

Paramétertulajdonságok

Típus:	PSCredential
Alapértelmezett érték:	Current user
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

-Force

Kényszeríti ezt a parancsmagot egy olyan elem létrehozására, amely egy meglévő írásvédett elemen keresztü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.

Paramétertulajdonságok

Típus:	SwitchParameter
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-ItemType

Az új elem szolgáltató által megadott típusát adja meg. A paraméter elérhető értékei a használt aktuális 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
• Csomópont
• HardLink

Megjegyzés:

A windowsos SymbolicLink típus létrehozásához rendszergazdai jogosultság szükséges. Azonban a Windows 10 (14972-s vagy újabb build) és a fejlesztői mód engedélyezve van, már nem igényel emelést szimbolikus hivatkozások létrehozásához.

Egy Certificate meghajtón a következő értékeket adhatja meg:

• Tanúsítványszolgáltató
• Bizonyítvány
• Store
• StoreLocation

További információ: about_Providers.

Paramétertulajdonságok

Típus:	String
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False
Aliasok:	Típus

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

-Name

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

Paramétertulajdonságok

Típus:	String
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

nameSet

Position:	Named
Kötelező:	True
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

-Path

Az új elem helyének elérési útját adja meg. Az alapértelmezett hely az aktuális hely, ha Elérési út nincs megadva. Megadhatja az új elem nevét Név, vagy felveheti Elérési út. A Név paraméterrel átadott elemek a Elérési út paraméter értékéhez viszonyítva jönnek létre.

Ebben a parancsmagban a Path paraméter a többi parancsmag LiteralPath 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 csillagot (*) tartalmazó fájlnevet.

Paramétertulajdonságok

Típus:	String[]
Alapértelmezett érték:	Current location
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

pathSet

Position:	0
Kötelező:	True
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

-Value

Az új elem értékét adja meg. Az értéket a New-Itemis becsúszthatja.

Paramétertulajdonságok

Típus:	Object
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False
Aliasok:	Cél

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	True
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

-WhatIf

Megjeleníti, mi történne, ha a parancsmag futna. A parancsmag nem fut.

Paramétertulajdonságok

Típus:	SwitchParameter
Alapértelmezett érték:	False
Támogatja a helyettesítő karaktereket:	False
DontShow:	False
Aliasok:	Wi

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

CommonParameters

Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.

Bevitelek

Object

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

Kimenetek

Object

Ez a parancsmag a létrehozott elemet adja vissza.

Jegyzetek

New-Item úgy tervezték, hogy bármely szolgáltató által közzétett adatokkal működjön együtt. A munkamenetben elérhető szolgáltatók listájához írja be a Get-PsProvider. További információért lásd a about_Providerscímű részt.

Kapcsolódó hivatkozások

• Elem törlése
• Másolás-Elem
• Get-Item (Elem lekérése)
• Invoke-Item
• Áthelyezés-Elem
• Elem eltávolítása
• Átnevezés-Elem
• Set-Item
• A szolgáltatókról