Syntaksi
mkdir <String> mkdir <String>] -Name <String> Kuvaus
New-Item-komentokomennolla luodaan uusi kohde ja asetetaan sen arvo. luotavien kohteiden tyypit riippuvat kohteen sijainnista. esimerkiksi tiedostojärjestelmässä New-Item-komentokomennolla luodaan tiedostoja ja kansioita. rekisterissä New-Item-komentokomennolla luodaan rekisteriavaimia ja -merkintöjä.
New-Item voi myös asettaa luomiensa kohteiden arvon.Esimerkiksi uutta tiedostoa luotaessa New-Item voi lisätä tiedostoon alkuperäisen sisällön.
Esimerkkejä
————————– ESIMERKKI 1 ————————–
PS C:\>new-item -path . -name testfile1.txt -itemtype "file" -value "This is a text string."Tämä komento luo tekstitiedoston nimeltä testitiedosto1.txt nykyiseen hakemistoon.Path-parametrin arvossa oleva piste (.) ilmaisee nykyisen hakemiston.Value-parametrin perässä oleva lainausmerkitetty teksti lisätään tiedostoon sisällöksi.
————————– ESIMERKKI 2 ————————–
PS C:\>new-item -path c:\ -name logfiles -itemtype directoryTämä komento luo hakemiston nimeltä Logfiles asemaan C:. ItemType-parametri määrittää, että uusi kohde on hakemisto, ei tiedosto tai muu tiedostojärjestelmän objekti.
————————– ESIMERKKI 3 ————————–
PS C:\>new-item -path $profile -itemtype file -forceTällä komennolla luodaan Windows PowerShell -profiili $profile-muuttujalla määritettyyn polkuun.
Voit käyttää profiileja Windows PowerShellin mukauttamiseen. $Profile on automaattinen (sisäänrakennettu) muuttuja, joka tallentaa CurrentUser/CurrentHost-profiilin polun ja tiedostonimen. oletusarvoisesti profiilia ei ole olemassa, vaikka Windows PowerShell tallentaa sille polun ja tiedostonimen.
Tässä komennossa $profile-muuttuja edustaa tiedoston polkua.ItemType-parametrilla määritetään, että komento luo tiedoston.Force-parametrin avulla voit luoda tiedoston profiilin polkuun, vaikka polun hakemistoja ei ole olemassa (Windows PowerShell luo ne).
Kun olet luonut profiilin tällä komennolla, voit syöttää profiiliin aliaksia, funktioita ja skriptejä komentotulkin mukauttamiseksi.
Lisätietoja on kohdissa about_Automatic_Variables ja about_Profiles.
————————– ESIMERKKI 4 ————————–
PS C:\>new-item -itemtype directory -path c:\ps-test\scriptsTämä komento luo uuden Scripts-hakemiston hakemistoon C:\PS-Test.
Uuden hakemistokohteen nimi Scripts sisältyy Path-parametrin arvoon sen sijaan, että se määritettäisiin Name-parametrin arvossa.Kuten syntaksista käy ilmi, kumpikin komentomuoto on pätevä.
————————– ESIMERKKI 5 ————————–
PS C:\>new-item -itemtype file -path "c:\ps-test\test.txt", "c:\ps-test\Logs\test.log"Tässä komennossa käytetään New-Item-cmdlet-ohjelmaa tiedostojen luomiseen kahteen eri hakemistoon.Koska Path-parametriin voidaan syöttää useita merkkijonoja, sen avulla voidaan luoda useita kohteita.
Pakolliset parametrit
Määrittää uuden kohteen nimen.
Voit määrittää uuden kohteen nimen Name- tai Path-parametrin arvossa ja voit määrittää uuden kohteen polun Name- tai Path-parametrin arvossa.
| Tyyppi: | Nimetty |
| Oletusarvo: | None |
| Accept pipeline input: | True (ByPropertyName) |
| Accept wildcard characters: | False |
Määrittää polun uuden kohteen sijaintiin. jokerimerkit ovat sallittuja.
Voit määrittää uuden kohteen nimen Name-parametrissa tai sisällyttää sen Path-parametriin.
| Tyyppi: | String |
| Position: | 1 |
| Oletusarvo: | None |
| Accept pipeline input: | True (ByPropertyName) |
| Accept wildcard characters: | False |
Valinnaiset parametrit
Kysyy vahvistusta ennen komentokomennon suorittamista.Kysyy vahvistusta ennen komentokomennon suorittamista.
| Type: | Nimetty |
| Oletusarvo: | False |
| Accept pipeline input: | False |
| Hyväksy jokerimerkkejä: | False |
Määrittää käyttäjätilin, jolla on oikeus suorittaa tämä toiminto. oletusarvo on nykyinen käyttäjä.
Kirjoita käyttäjänimi, kuten ”User01” tai ”Domain01\User01”, tai anna PSCredential-objekti, esimerkiksi Get-Credential-cmdletillä luotu PSCredential-objekti.Jos kirjoitat käyttäjänimen, sinua pyydetään antamaan salasana.
Tätä parametria ei tue mikään Windows PowerShellin kanssa asennettu palveluntarjoaja
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | True (ByPropertyName) |
| Accept wildcard characters: | False |
Mahdollistaa komennon luomisen kohteen, joka kirjoittaa olemassa olevan vain lukuoikeuden alaisen kohteen päälle.Toteutus vaihtelee palveluntarjoajakohtaisesti.Lisätietoja on osoitteessa about_Providers.Force-parametrin käytössäkään komentokomento ei voi ohittaa suojausrajoituksia.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Hyväksy jokerimerkkejä: | False |
Sisällyttää komennon aktiiviseen transaktioon.Tämä parametri on voimassa vain, kun transaktio on käynnissä.Lisätietoja on osoitteessa Sisällyttää komennon aktiiviseen transaktioon.Tämä parametri on voimassa vain, kun transaktio on käynnissä.Lisätietoja on osoitteessa
| Type: | Named |
| Default value: | False |
| Accept pipeline input: | False |
| Hyväksy jokerimerkkejä: | False |
Määrittää uuden kohteen arvon. voit myös putkella arvon New-Item.
| Type: | Object |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | True (ByPropertyName, ByValue) |
| Accept wildcard characters: | False |
Näyttää, mitä tapahtuisi, jos cmdlet suoritetaan. cmdlet ei suoriteta.
| Type: | Named |
| Default value: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Syötteet
System.Object
Voit antaa putkessa uuden kohteen arvon New-Item-cmdletille.
Tulokset
System.Object
New-Item palauttaa luomansa kohteen.
Huomautuksia
New-Item-cmdlet on suunniteltu toimimaan minkä tahansa palveluntarjoajan paljastamien tietojen kanssa.Voit luetella istunnossa käytettävissä olevat palveluntarjoajat kirjoittamalla ”Get-PsProvider”.Lisätietoja on kohdassa about_Providers.
- Clear-Item
- Copy-Item
- Get-Item
- Invoke-Item
- Move-Item
- Remove-Item
- Rename-Item
- Set-Item
- about_Providers