New-Item

Modul:

Microsoft.PowerShell.Management Module

Új elemet hoz létre.

Syntax

pathSet (Default) - All providers

New-Item
    [-Path] <string[]>
    [-ItemType <string>]
    [-Value <Object>]
    [-Force]
    [-Credential <pscredential>]
    [-WhatIf]
    [-Confirm]
    [-UseTransaction]
    [<CommonParameters>]

nameSet - All providers

New-Item
    [[-Path] <string[]>]
    -Name <string>
    [-ItemType <string>]
    [-Value <Object>]
    [-Force]
    [-Credential <pscredential>]
    [-WhatIf]
    [-Confirm]
    [-UseTransaction]
    [<CommonParameters>]

pathSet (Default) - WSMan provider

New-Item
    [-Path] <string[]>
    -ConnectionURI <uri>
    [-ItemType <string>]
    [-Value <Object>]
    [-Force]
    [-Credential <pscredential>]
    [-WhatIf]
    [-Confirm]
    [-UseTransaction]
    [-OptionSet <hashtable>]
    [-Authentication <AuthenticationMechanism>]
    [-CertificateThumbprint <string>]
    [-SessionOption <SessionOption>]
    [-Port <int>]
    [<CommonParameters>]

nameSet - WSMan provider

New-Item
    [[-Path] <string[]>]
    -Name <string>
    [-ItemType <string>]
    [-Value <Object>]
    [-Force]
    [-Credential <pscredential>]
    [-WhatIf]
    [-Confirm]
    [-UseTransaction]
    [-OptionSet <hashtable>]
    [-Authentication <AuthenticationMechanism>]
    [-CertificateThumbprint <string>]
    [-SessionOption <SessionOption>]
    [-ApplicationName <string>]
    [-Port <int>]
    [-UseSSL]
    [<CommonParameters>]

pathSet (Alapértelmezett)

New-Item
    [-Path] <string[]>
    [-ItemType <string>]
    [-Value <Object>]
    [-Force]
    [-Credential <pscredential>]
    [-WhatIf]
    [-Confirm]
    [-UseTransaction]
    [-Options <ScopedItemOptions>]
    [<CommonParameters>]

nameSet

New-Item
    [[-Path] <string[]>]
    -Name <string>
    [-ItemType <string>]
    [-Value <Object>]
    [-Force]
    [-Credential <pscredential>]
    [-WhatIf]
    [-Confirm]
    [-UseTransaction]
    [-Options <ScopedItemOptions>]
    [<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"

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éljának teljes elérési útnak kell lennie.

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, amint az a Length tulajdonságnál látható.

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

-ApplicationName

Ez a WSMan szolgáltató által elérhetővé tett dinamikus paraméter. A WSMan szolgáltató és ez a paraméter csak Windows rendszeren érhető el.

Megadja az alkalmazás nevét a kapcsolatban. Az ApplicationName paraméter alapértelmezett értéke WSMAN.

További információ: New-WSManInstance.

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ő:	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

-Authentication

Ez a WSMan szolgáltató által elérhetővé tett dinamikus paraméter. A WSMan szolgáltató és ez a paraméter csak Windows rendszeren érhető el.

Megadja a kiszolgálón használandó hitelesítési mechanizmust.

További információ: New-WSManInstance.

Paramétertulajdonságok

Típus:	AuthenticationMechanism
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

-CertificateThumbprint

Ez a WSMan szolgáltató által elérhetővé tett dinamikus paraméter. A WSMan szolgáltató és ez a paraméter csak Windows rendszeren érhető el.

Megadja a WSMan-művelet végrehajtásához engedéllyel rendelkező felhasználói fiók digitális nyilvános kulcsú tanúsítványát (X509). Adja meg a tanúsítvány ujjlenyomatát.

További információ: New-WSManInstance.

Paramétertulajdonságok

Típus:	String
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

-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

-ConnectionURI

Ez a WSMan szolgáltató által elérhetővé tett dinamikus paraméter. A WSMan szolgáltató és ez a paraméter csak Windows rendszeren érhető el.

A WSMan kapcsolati végpontjának megadása.

További információ: New-WSManInstance.

Paramétertulajdonságok

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

Paraméterkészletek

pathSet

Position:	Named
Kötelező:	True
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.

A Force nem használható meglévő csomópont felülírására. A meglévő csomópont felülírására tett kísérletek "nem távolíthatók el, mert nem üres" hibaüzenettel meghiúsulnak. Új csomópont létrehozása előtt el kell távolítania a meglévő csomópontot.

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:

• File
• Directory
• SymbolicLink
• Junction
• 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:

• Certificate Provider
• Certificate
• 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

-Options

Ez a Alias szolgáltató által elérhetővé tett dinamikus paraméter. További információ: New-Alias.

Egy alias Beállítások tulajdonságának értékét adja meg.

Az érvényes értékek a következők:

• None: Az alias nem rendelkezik korlátozásokkal (alapértelmezett érték)
• ReadOnly: Az alias törölhető, de nem módosítható a Force paraméter használata nélkül
• Constant: Az alias nem törölhető vagy módosítható
• Private: Az alias csak az aktuális hatókörben érhető el
• AllScope: Az alias minden létrehozott új hatókörbe lesz másolva
• Unspecified: A beállítás nincs megadva

Paramétertulajdonságok

Típus:	ScopedItemOptions
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

-OptionSet

Ez a WSMan szolgáltató által elérhetővé tett dinamikus paraméter. A WSMan szolgáltató és ez a paraméter csak Windows rendszeren érhető el.

A kérés jellegének módosításához vagy finomításához kapcsolókat ad át egy szolgáltatásra.

További információ: New-WSManInstance.

Paramétertulajdonságok

Típus:	Hashtable
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False
Aliasok:	Operációs rendszer

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

-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 csillag (*) karaktert tartalmazó fájlnév.

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

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

-Port

Ez a WSMan szolgáltató által elérhetővé tett dinamikus paraméter. A WSMan szolgáltató és ez a paraméter csak Windows rendszeren érhető el.

Megadja azt a portot, amelyet az ügyfél a WinRM szolgáltatáshoz való csatlakozáskor használ.

További információ: New-WSManInstance.

Paramétertulajdonságok

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

Paraméterkészletek

(All)

Position:	Named
Kötelező:	True
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

-SessionOption

Ez a WSMan szolgáltató által elérhetővé tett dinamikus paraméter. A WSMan szolgáltató és ez a paraméter csak Windows rendszeren érhető el.

A WS-Management munkamenet kibővített beállításait határozza meg.

További információ: New-WSManInstance.

Paramétertulajdonságok

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

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

-UseSSL

Ez a WSMan szolgáltató által elérhetővé tett dinamikus paraméter. A WSMan szolgáltató és ez a paraméter csak Windows rendszeren érhető el.

Meghatározza, hogy a távoli számítógéphez való csatlakozáshoz a Secure Sockets Layer (SSL) protokollt kell használni. Alapértelmezés szerint az SSL nem használatos.

További információ: New-WSManInstance.

Paramétertulajdonságok

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

Paraméterkészletek

nameSet

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

-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 parancsprogram nem lett futtatva.

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

DictionaryEntry

A parancsmag egy DictionaryEntry objektumot ad vissza egy új környezeti változó létrehozásakor.

DirectoryInfo

A parancsmag egy DirectoryInfo objektumot ad vissza, amikor új könyvtárat hoz létre a fájlrendszerben.

FileInfo

A parancsmag egy FileInfo objektumot ad vissza, amikor új fájlt hoz létre a fájlrendszerben.

AliasInfo

A parancsmag egy AliasInfo objektumot ad vissza új alias létrehozásakor.

FunctionInfo

A parancsmag egy FunctionInfo objektumot ad vissza új függvény létrehozásakor.

PSVariable

A parancsmag egy PSVariable objektumot ad vissza új változó létrehozásakor.

Jegyzetek

A Windows PowerShell a New-Itemkövetkező aliasait tartalmazza:

• ni

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