Syntaks
mkdir <String>
mkdir <String>] -Name <String>
Beskrivelse
Cmdletten New-Item opretter et nyt element og angiver dets værdi. de typer af elementer, der kan oprettes, afhænger af elementets placering. i filsystemet bruges New-Item f.eks. til at oprette filer og mapper. i registreringsdatabasen opretter New-Item registreringsdatabasenøgler og poster.
New-Item kan også indstille værdien af de elementer, som det opretter. når der f.eks. oprettes en ny fil, kan New-Item tilføje indledende indhold til filen.
Eksempler
————————– EKSEMPEL 1 ————————–
PS C:\>new-item -path . -name testfile1.txt -itemtype "file" -value "This is a text string."
Denne kommando opretter en tekstfil ved navn testfile1.txt i den aktuelle mappe. punktummet (.) i værdien af Path-parameteren angiver den aktuelle mappe. den tekst i anførselstegn, der følger efter Value-parameteren, tilføjes til filen som indhold.
————————– EKSEMPEL 2 ————————–
PS C:\>new-item -path c:\ -name logfiles -itemtype directory
Denne kommando opretter en mappe ved navn Logfiles i C:-drevet. parameteren ItemType angiver, at det nye element er en mappe og ikke en fil eller et andet filsystemobjekt.
————————– EKSEMPEL 3 ————————–
PS C:\>new-item -path $profile -itemtype file -force
Denne kommando opretter en Windows PowerShell-profil i den sti, der er angivet med variablen $profile.
Du kan bruge profiler til at tilpasse Windows PowerShell. $Profile er en automatisk (indbygget) variabel, der gemmer stien og filnavnet for CurrentUser/CurrentHost-profilen. som standard findes profilen ikke, selv om Windows PowerShell gemmer en sti og et filnavn for den.
I denne kommando repræsenterer variablen $profile stien til filen. parameteren ItemType angiver, at kommandoen opretter en fil. parameteren Force giver dig mulighed for at oprette en fil i profilstien, selv om mapperne i stien ikke findes (Windows PowerShell opretter dem).
Når du har brugt denne kommando til at oprette en profil, kan du indtaste aliaser, funktioner og scripts i profilen for at tilpasse din shell.
Du kan finde flere oplysninger under about_Automatic_Variables og about_Profiles.
————————– EKSEMPEL 4 ————————–
PS C:\>new-item -itemtype directory -path c:\ps-test\scripts
Denne kommando opretter en ny mappe Scripts i mappen C:\PS-Test.
Navnet på det nye mappeelement, Scripts, er medtaget i værdien af Path-parameteren i stedet for at blive angivet i værdien af Name-parameteren.Som angivet i syntaksen er begge kommando-former gyldige.
————————– EKSEMPEL 5 ————————–
PS C:\>new-item -itemtype file -path "c:\ps-test\test.txt", "c:\ps-test\Logs\test.log"
I denne kommando bruges cmdletten New-Item til at oprette filer i to forskellige mapper.Fordi Path-parameteren tager flere strenge, kan du bruge den til at oprette flere elementer.
Krævede parametre
-Name
Angiver navnet på det nye element.
Du kan angive navnet på det nye element i parameterværdien Navn eller Sti, og du kan angive stien til det nye element i parameterværdien Navn eller Sti.
Type:
Type:
Type:
Type:
Type: |
String |
Position: |
Navngivet |
Standardværdi: |
Standardværdi: |
Ingen |
Accepterer input fra rørledningen: |
True (ByPropertyName) |
Accepter wildcard-tegn: |
Falsk |
-Path
Angiver stien til placeringen af det nye element.Jokertegn er tilladt.
Du kan angive navnet på det nye element i parameteren Navn eller medtage det i parameteren Sti.
Type: |
String |
Position: |
1 |
Standardværdi: |
Standardværdi: |
Ingen |
Accepterer input fra rørledningen: |
True (ByPropertyName) |
Accepter jokertegn: |
Accepter jokertegn: |
Falsk |
Valgfrie parametre
-Confirm
Opfordrer dig til at bekræfte, før du kører cmdletten.Opfordrer dig til at bekræfte, før du kører cmdletten.
Type: |
SwitchParameter |
Aliaser: |
|
cf |
Position: |
|
Navngivet |
Standardværdi: |
Falsk |
Accepterer input fra rørledningen: |
Falsk |
Accepter wildcard-tegn: |
Falsk |
-Credential
Angiver en brugerkonto, der har tilladelse til at udføre denne handling.Standardværdien er den aktuelle bruger.
Indtast et brugernavn, f.eks. “User01” eller “Domain01\User01”, eller indtast et PSCredential-objekt, f.eks. et objekt, der genereres af cmdletten Get-Credential.Hvis du indtaster et brugernavn, bliver du bedt om at angive en adgangskode.
Denne parameter understøttes ikke af nogen udbydere, der er installeret med Windows PowerShell
Type: |
PSCredential |
Type: |
Position: |
Navngivet |
Standardværdi: |
Standardværdi: |
Ingen |
Accepterer input fra rørledningen: |
True (ByPropertyName) |
Accepter wildcard-tegn: |
Falsk |
-Force
Giver cmdletten mulighed for at oprette et element, der skriver over et eksisterende skrivebeskyttet element.Implementeringen varierer fra provider til provider.Du kan finde flere oplysninger i about_Providers.Selv ved hjælp af Force-parameteren kan cmdletten ikke tilsidesætte sikkerhedsrestriktioner.
Type: |
SwitchParameter |
Position: |
|
Navngivet |
Standardværdi: |
Standardværdi: |
Ingen |
Accepterer input fra rørledningen: |
Falsk |
Accepter wildcard-tegn: |
Falsk |
-UseTransaction
Inkluderer kommandoen i den aktive transaktion.Denne parameter er kun gyldig, når en transaktion er i gang.For yderligere oplysninger, se Inkluderer kommandoen i den aktive transaktion.Denne parameter er kun gyldig, når en transaktion er i gang.For yderligere oplysninger, se
| |
SwitchParameter |
Aliaser: |
|
usetx |
Position: |
|
Navngivet |
Standardværdi: |
Falsk |
Accepterer input fra rørledningen: |
Falsk |
Accepter wildcard-tegn: |
Falsk |
-Value
Angiver værdien af det nye emne.Du kan også angive en værdi i rørledningen til New-Item.
Type: |
Objekt |
Position: |
Position: |
Navngivet |
Standardværdi: |
Standardværdi: |
Ingen |
Accepterer input fra rørledningen: |
True (ByPropertyName, ByValue) |
Accepter wildcard-tegn: |
False |
-WhatIf
Viser, hvad der ville ske, hvis cmdletten køres.cmdletten køres ikke.
Type: |
SwitchParameter |
Aliaser: |
|
wi |
Position: |
|
Navngivet |
Standardværdi: |
Falsk |
Accepterer input fra rørledningen: |
Falsk |
Accepter wildcard-tegn: |
Falsk |
Indgange
System.Object
Du kan indsætte en værdi for det nye element i rørledningen til cmdlet’en New-Item.
Udgange
System.Object
New-Item returnerer det element, som den opretter.
Bemærkninger
Cmdletten New-Item er designet til at arbejde med de data, der eksponeres af en hvilken som helst provider.Du kan få vist en liste over de providers, der er tilgængelige i din session, ved at skrive “Get-PsProvider”.Du kan finde flere oplysninger under about_Providers.
- Clear-Item
- Copy-Item
- Get-Item
- Invoke-Item
- Move-Item
- Move-Item
- Remove-Item
- Rename-Item
- Rename-Item
- Set-Item
- about_Providers
|
|
|