New-Item

Modul:

Microsoft.PowerShell.Management

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

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

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

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

New-Item
   [[-Path] <string[]>]
   -Name <string>
   [-ItemType <string>]
   [-Value <Object>]
   [-Force]
   [-Credential <pscredential>]
   [-WhatIf]
   [-Confirm]
   [-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 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 az általa létrehozott elemek értékét is beállíthatja. Ha például létrehoz egy új fájlt, New-Item felvehet kezdeti tartalmat a fájlba.

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

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 címtá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.

Az új könyvtárelem ,,Szkriptek" neve szerepel az Elérési út paraméter értékében, ahelyett, hogy a 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 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: 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 az Elérési út paraméterben. Az alábbi parancs létrehoz egy temp.txt fájlt az Elérési út paraméter helyettesítő karakterei á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ár összes könyvtárában. A New-Item parancsmag kibocsátja a létrehozott elemeket, amelyek az újonnan létrehozott fájlok elérési útvonalának ellenőrzésére Select-Object lettek beállítva.

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 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 út használatával létrehozhat egy SymbolicLinket egy Windows-mappához.

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 megkísérli létrehozni ugyanazt a mappát a következővel -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, ahogy a hossz tulajdonság is 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

Feljegyzés

New-Item Amikor a -Force kapcsolóval beállításkulcsokat hoz létre, 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 a WSMAN.

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

Típus:	String
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	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.

Típus:	AuthenticationMechanism
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	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.

Típus:	String
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-Confirm

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

Típus:	SwitchParameter
Aliasok:	cf
Position:	Named
Alapértelmezett érték:	False
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	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.

Típus:	Uri
Position:	Named
Alapértelmezett érték:	None
Kötelező:	True
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-Credential

Feljegyzé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: .

Típus:	PSCredential
Position:	Named
Alapértelmezett érték:	Current user
Kötelező:	False
Folyamatbemenet elfogadása:	True
Helyettesítő karakterek elfogadása:	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 PowerShell 7.4-től kezdődően ez a paraméter lehetővé teszi egy meglévő csomópont felülírását is. Korábban ez "nem távolítható el, mert nem üres" hibaüzenettel hiúsul meg.

Típus:	SwitchParameter
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	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

Feljegyzés

A SymbolicLink windowsos típus létrehozásához rendszergazdai jogosultságszint-emelt szintű 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.

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.

Típus:	String
Aliasok:	Type
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	True
Helyettesítő karakterek elfogadása:	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ékében 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 neve az Elérési út paraméter értékéhez viszonyítva jön létre.

Típus:	String
Position:	Named
Alapértelmezett érték:	None
Kötelező:	True
Folyamatbemenet elfogadása:	True
Helyettesítő karakterek elfogadása:	False

-Options

Ez egy dinamikus paraméter, amelyet az Alias-szolgáltató tett elérhetővé. 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 a Force paraméter használata nélkül nem módosítható
• 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 át lesz másolva a létrehozott új hatókörökbe
• Unspecified: A beállítás nincs megadva

Típus:	ScopedItemOptions
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	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.

Típus:	Hashtable
Aliasok:	OS
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-Path

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

Ebben a parancsmagban az Elérési út paraméter más parancsmagok 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.

Típus:	String[]
Position:	0
Alapértelmezett érték:	Current location
Kötelező:	False
Folyamatbemenet elfogadása:	True
Helyettesítő karakterek elfogadása:	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.

Típus:	Int32
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	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 kiterjesztett beállításait határozza meg.

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

Típus:	SessionOption
Aliasok:	SO
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	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.

Típus:	SwitchParameter
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-Value

Az új elem értékét adja meg. Azt is megteheti, hogy becsúszt egy értéket.New-Item

Típus:	Object
Aliasok:	Target
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	True
Helyettesítő karakterek elfogadása:	False

-WhatIf

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

Típus:	SwitchParameter
Aliasok:	wi
Position:	Named
Alapértelmezett érték:	False
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

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 egy új alias létrehozásakor.

FunctionInfo

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

PSVariable

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

Jegyzetek

A PowerShell a következő aliasokat New-Itemtartalmazza:

• Minden platform:
  • ni

New-Item ú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ájához írja be a következőt Get-PsProvider: További információ: about_Providers.

Kapcsolódó hivatkozások

• Clear-Item
• Copy-Item
• Get-Item
• Invoke-Item
• Move-Item
• Remove-Item
• Rename-Item
• Set-Item
• about_Providers