Szintaxis
mkdir <String>
mkdir <String>] -Name <String>
Leírás
A New-Item cmdlet új elemet hoz létre, és beállítja annak értékét. a létrehozható elemek típusai az elem helyétől függnek. például a fájlrendszerben a New-Item segítségével fájlok és mappák hozhatók létre. a registryben a New-Item a registry kulcsokat és bejegyzéseket hoz létre.
A New-Item az általa létrehozott elemek értékét is beállíthatja.Például egy új fájl létrehozásakor a New-Item hozzáadhatja a fájl kezdeti tartalmát.
Példák
————————– 1. PÉLDA ————————–
PS C:\>new-item -path . -name testfile1.txt -itemtype "file" -value "This is a text string."
Ez a parancs létrehoz egy testfile1.txt nevű szöveges fájlt az aktuális könyvtárban.A Path paraméter értékében lévő pont (.) az aktuális könyvtárat jelzi.Az Value paramétert követő idézőjeles szöveg tartalomként kerül a fájlba.
————————– 2. PÉLDA ————————–
PS C:\>new-item -path c:\ -name logfiles -itemtype directory
Ez a parancs létrehoz egy Logfiles nevű könyvtárat a C: meghajtóban.Az ItemType paraméter megadja, hogy az új elem egy könyvtár, nem pedig egy fájl vagy más fájlrendszerobjektum.
————————– 3. PÉLDA ————————–
PS C:\>new-item -path $profile -itemtype file -force
Ez a parancs létrehoz egy Windows PowerShell-profilt a $profile változó által megadott elérési útvonalon.
A Windows PowerShell testreszabásához profilokat használhat. $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 Windows PowerShell tárolja az elérési útját és fájlnevét.
Ebben a parancsban a $profile változó a fájl elérési útvonalát jelöli. az ItemType paraméter megadja, hogy a parancs fájlt hoz létre. a Force paraméterrel létrehozhat egy fájlt a profil elérési útvonalán, még akkor is, ha az útvonalban lévő könyvtárak nem léteznek (a Windows PowerShell létrehozza őket).
Miután ezzel a paranccsal létrehozott egy profilt, aliasokat, függvényeket és szkripteket adhat meg a profilban a héj testreszabásához.
További információkért lásd a about_Automatic_Variables és a about_Profiles című fejezeteket.
————————– 4. PÉLDA ————————–
PS C:\>new-item -itemtype directory -path c:\ps-test\scripts
Ez a parancs egy új Scripts könyvtárat hoz létre a C:\PS-Test könyvtárban.
Az új könyvtárelem neve, Scripts, a Path paraméter értékében szerepel, ahelyett, hogy a Name paraméter értékében lenne megadva.Ahogy a szintaxis is jelzi, mindkét parancsforma érvényes.
————————– 5. PÉLDA ————————–
PS C:\>new-item -itemtype file -path "c:\ps-test\test.txt", "c:\ps-test\Logs\test.log"
Ez a parancs a New-Item cmdlet segítségével két különböző könyvtárban hoz létre fájlokat.Mivel a Path paraméter több karakterláncot is elfogad, több elem létrehozására is használható.
Kötelező paraméterek
Megadja az új elem nevét.
A Name vagy Path paraméterértékben megadhatja az új elem nevét, a Name vagy Path paraméterértékben pedig az új elem elérési útvonalát.
Type: | String |
Position: | Megnevezett |
Alapértelmezett érték: | None |
Accept pipeline input: | True (ByPropertyName) |
Wildcard karakterek elfogadása: | False |
Megadja az új elem helyének elérési útvonalát.Wildcardok használata megengedett.
Megadhatja az új elem nevét a Name paraméterben, vagy megadhatja az Path paraméterben.
Type: | String |
Position: | 1 |
Alapértelmezett érték: | None |
Accept pipeline input: | True (ByPropertyName) |
Wildcard karakterek elfogadása: | False |
Opcionális paraméterek
A cmdlet futtatása előtt megerősítésre szólít fel.
Type: | Named |
Alapértelmezett érték: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Megad egy olyan felhasználói fiókot, amely jogosult a művelet végrehajtására.Az alapértelmezett az aktuális felhasználó.
Írjon be egy felhasználónevet, például “User01” vagy “Domain01\User01”, vagy adjon meg egy PSCredential objektumot, például a Get-Credential cmdlet által generáltat.Ha felhasználónevet ír be, a rendszer kéri a jelszó megadását.
Ezt a paramétert a Windows PowerShell-lel telepített szolgáltatók nem támogatják
Type: | PSCredential |
Position: | Név: |
Alapértelmezett érték: | None |
Accept pipeline input: | True (ByPropertyName) |
Wildcard karakterek elfogadása: | False |
Lehetővé teszi a cmdlet számára egy olyan elem létrehozását, amely felülír egy meglévő, csak olvasható elemet.A végrehajtás szolgáltatótól függően változik.További információért lásd: about_Providers.Még a Force paraméter használatával sem írhatja felül a cmdlet a biztonsági korlátozásokat.
Type: | SwitchParameter |
Position: | Named |
Alapértelmezett érték: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Beleértve a parancsot az aktív tranzakcióba.Ez a paraméter csak akkor érvényes, ha a tranzakció folyamatban van.További információért lásd Beleértve a parancsot az aktív tranzakcióba.Ez a paraméter csak akkor érvényes, ha a tranzakció folyamatban van.További információért lásd
Type: | usetx | |
Position: | Névre szóló | |
Alapértelmezett érték: | ||
Névre szóló | Névre szóló | Alapértelmezett érték: | False |
Accept pipeline input: | False | |
Accept wildcard characters: | False |
Megadja az új elem értékét.A New-Itemhez értéket is megadhat.
Type: | Object |
Position: | Named |
Alapértelmezett érték: | None |
Accept pipeline input: | True (ByPropertyName, ByValue) |
Wildcard karakterek elfogadása: | False |
Megmutatja, mi történne, ha a cmdlet futna.A cmdlet nem fut.
Type: | wi |
Position: | Named |
Default value: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Bemenetek
System.Object
A New-Item cmdlethez az új elem értékét csővezetéken adhatja meg.
Kimenetek
System.Object
A New-Item visszaadja az általa létrehozott elemet.
Megjegyzések
A New-Item cmdletet úgy tervezték, hogy bármely szolgáltató által közzétett adatokkal dolgozhasson.A munkamenetben elérhető szolgáltatók listájához írja be a “Get-PsProvider” parancsot.További információért lásd: about_Providers.
- Clear-Item
- Copy-Item
- Get-Item
- Invoke-Item
- Move-Item
- Remove-Item
- Rename-Item
- Set-Item
- about_Providers
.