New-Item
Új elemet hoz létre.
Syntax
pathSet (Alapértelmezett)
New-Item
[-Path] <String[]>
[-ItemType <String>]
[-Value <Object>]
[-Force]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[-UseTransaction]
[<CommonParameters>]
nameSet
New-Item
[[-Path] <String[]>]
-Name <String>
[-ItemType <String>]
[-Value <Object>]
[-Force]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[-UseTransaction]
[<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
Megjegyzés:
Ha ezzel a módszerrel hoz létre egy fájlt, az eredményül kapott fájl UTF-8 formátumban lesz kódolva bájt-order-mark (BOM) nélkül.
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"
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ő. További információért lásd a about_Providerscímű részt. 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
Ha ezzel a módszerrel hoz létre egy fájlt, az eredményül kapott fájl UTF-8 formátumban lesz kódolva bájt-order-mark (BOM) nélkül.
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.
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. A helyettesítő karakterek használata engedélyezett.
Megadhatja az új elem nevét Név, vagy felveheti Elérési út.
Paramétertulajdonságok
| Típus: | String[] |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | True |
| 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 |
nameSet
| Position: | 0 |
| 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 |
-UseTransaction
Tartalmazza a parancsot az aktív tranzakcióban. Ez a paraméter csak akkor érvényes, ha egy tranzakció folyamatban van. További információ: about_Transactions.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | False |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | usetx |
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 |
-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.