New-Item

Syntax

New-Item <String> 

New-Item <String>] -Name <String> 

Description

New-Item-komento luo uuden kohteen ja asettaa sen arvon. Luodut kohdetyypit riippuvat kohteen sijainnista. Esimerkiksi tiedostojärjestelmässä New-Item luo tiedostoja ja kansioita. Rekisterissä New-Item luo rekisteriavaimia ja -merkintöjä.

New-Item voi myös asettaa luomiensa kohteiden arvon. Esimerkiksi luodessaan uuden tiedoston New-Item voi lisätä tiedostoon alkuperäisen sisällön.

Esimerkkejä

Esimerkki 1: Tiedoston luominen nykyiseen hakemistoon

Tällä komennolla luodaan nykyiseen hakemistoon tekstitiedosto, jonka nimi on ”testfile1.txt”. Path-parametrin arvossa oleva piste(’.’) ilmaisee nykyisen hakemiston. Value-parametrin perässä oleva lainausmerkitetty teksti lisätään tiedostoon sisällöksi.

New-Item -Path . -Name "testfile1.txt" -ItemType "file" -Value "This is a text string."

Esimerkki 2: Hakemiston luominen

Tämä komento luo hakemiston nimeltä ”Lokitiedostot” C:-asemaan. ItemType-parametri määrittelee, että uusi kohde on hakemisto, ei tiedosto tai muu tiedostojärjestelmän objekti.

New-Item -Path "c:\" -Name "logfiles" -ItemType "directory"

Esimerkki 3: Luo profiili

Tämä komento luo PowerShell-profiilin muuttujan $profile määrittämässä polussa.

Profiileja voi käyttää PowerShellin mukauttamiseen. $profile on automaattinen (sisäänrakennettu) muuttuja, jokatallentaa ”CurrentUser/CurrentHost”-profiilin polun ja tiedostonimen. Oletusarvoisesti profiilia ei ole olemassa, vaikka PowerShell tallentaa sille polun ja tiedostonimen.

Tässä komennossa muuttuja $profile edustaa tiedoston polkua. ItemType-parametrimäärittää, että komento luo tiedoston. Force-parametrin avulla voit luoda tiedoston profiilin polkuun, vaikka polun hakemistoja ei olisikaan.

Kun olet luonut profiilin, voit syöttää profiiliin aliaksia, funktioita ja skriptejä komentotulkkisi mukauttamiseksi.

Lisätietoja on kohdassa about_Automaattiset_muuttujatja about_Profiilit.

New-Item -Path $profile -ItemType "file" -Force

Esimerkki 4: Luo hakemisto toiseen hakemistoon

Tämä esimerkki luo uuden Scripts-hakemiston hakemistoon ”C:\PS-Test”.

Uuden hakemistokohdan nimi ”Scripts” sisältyy Path-parametrin arvoon,sen sijaan,että se määritettäisiin Name-parametrin arvossa. Kuten syntaksista käy ilmi, kumpikin komentomuotoon kelvollinen.

New-Item -ItemType "directory" -Path "c:\ps-test\scripts"

Esimerkki 5: Luo useita tiedostoja

Tämä esimerkki luo tiedostoja kahteen eri hakemistoon. Koska Path ottaa useita merkkijonoja,voit käyttää sitä useiden kohteiden luomiseen.

New-Item -ItemType "file" -Path "c:\ps-test\test.txt", "c:\ps-test\Logs\test.log"

Esimerkki 6: Luo tiedostoja useisiin hakemistoihin jokerimerkkien avulla

Komento New-Item tukee jokerimerkkejä Path-parametrissa. Seuraava komento luotemp.txt-tiedoston kaikkiin Path-parametrin jokerimerkkien määrittelemiin hakemistoihin.

Get-ChildItem -Path C:\Temp\Directory: C:\TempMode LastWriteTime Length Name---- ------------- ------ ----d----- 5/15/2019 6:45 AM 1 Oned----- 5/15/2019 6:45 AM 1 Twod----- 5/15/2019 6:45 AM 1 ThreeNew-Item -Path * -Name temp.txt -ItemType File | Select-Object FullNameFullName--------C:\Temp\One\temp.txtC:\Temp\Three\temp.txtC:\Temp\Two\temp.txt

Cmdlet Get-ChildItem näyttää kolme hakemistoa hakemiston C:\Temp alla. Jokerimerkkejä käyttämällä New-Item-cmdlet luo temp.txt-tiedoston kaikkiin nykyisen hakemiston alla oleviin hakemistoihin. New-Item cmdlet tulostaa luodut kohteet, jotka ohjataan putkella Select-Object:een, jotta voidaan tarkistaa äskettäin luotujen tiedostojen polut.

Esimerkki 7: Luo symbolinen linkki tiedostoon tai kansioon

Tässä esimerkissä luodaan symbolinen linkki nykyisessä kansiossa olevaan tiedostoon Notice.txt.txt.

$link = New-Item -ItemType SymbolicLink -Path .\link -Target .\Notice.txt$link | Select-Object LinkType, TargetLinkType Target-------- ------SymbolicLink {.\Notice.txt}

Tässä esimerkissä Target on alias Value-parametrille. Symbolisen linkin kohde voi olla suhteellinen polku. Ennen PowerShell v6.2:ta kohteen on oltava täysin määritetty polku.

PowerShell 7.1:stä alkaen voit nyt luoda symbolisen linkin Windows-kansioon käyttämällä relatiivista polkua.

Esimerkki 8: Käytä -Force-parametria yrittäessäsi luoda kansioita uudelleen

Tässä esimerkissä luodaan kansio, jonka sisällä on tiedosto. Sitten yritetään luoda sama kansio käyttämällä-Force. Se ei korvaa kansiota, vaan palauttaa vain olemassa olevan kansio-objektin, jossa luotu tiedosto on koskemattomana.

PS> New-Item -Path .\TestFolder -ItemType DirectoryPS> New-Item -Path .\TestFolder\TestFile.txt -ItemType FilePS> New-Item -Path .\TestFolder -ItemType Directory -Force Directory: C:\Mode LastWriteTime Length Name---- ------------- ------ ----d----- 5/1/2020 8:03 AM TestFolderPS> Get-ChildItem .\TestFolder\ Directory: C:\TestFolderMode LastWriteTime Length Name---- ------------- ------ -----a---- 5/1/2020 8:03 AM 0 TestFile.txt

Esimerkki 9: Käytä -Force-parametria olemassa olevien tiedostojen ylikirjoittamiseen

Tässä esimerkissä luodaan tiedosto, jossa on arvo, ja sen jälkeen tiedosto luodaan uudelleen käyttämällä -Force. Tämä ylikirjoittaaOlemassa olevan tiedoston ja se menettää sisältönsä, kuten näet length-ominaisuudesta

PS> New-Item ./TestFile.txt -ItemType File -Value 'This is just a test file' Directory: C:\Source\TestMode LastWriteTime Length Name---- ------------- ------ -----a---- 5/1/2020 8:32 AM 24 TestFile.txtNew-Item ./TestFile.txt -ItemType File -Force Directory: C:\Source\TestMode LastWriteTime Length Name---- ------------- ------ -----a---- 5/1/2020 8:32 AM 0 TestFile.txt

Parameters