Syntax
mkdir <String>
mkdir <String>] -Name <String>
Beskrivning
Cmdletten New-Item skapar ett nytt objekt och fastställer dess värde. de typer av objekt som kan skapas beror på var objektet är placerat. i filsystemet används New-Item till exempel för att skapa filer och mappar. i registret skapar New-Item registernycklar och registerposter.
New-Item kan också ställa in värdet på de objekt som den skapar. till exempel när den skapar en ny fil kan New-Item lägga till initialt innehåll till filen.
Exempel
————————– EXEMPEL 1 ————————–
PS C:\>new-item -path . -name testfile1.txt -itemtype "file" -value "This is a text string."
Det här kommandot skapar en textfil med namnet testfile1.txt i den aktuella katalogen. pricken (.) i värdet för Path-parametern anger den aktuella katalogen. den citerade texten som följer efter Value-parametern läggs till filen som innehåll.
————————– EXEMPEL 2 ————————–
PS C:\>new-item -path c:\ -name logfiles -itemtype directory
Det här kommandot skapar en katalog som heter Logfiles i enheten C:. Parametern ItemType anger att det nya objektet är en katalog, inte en fil eller ett annat filsystemobjekt.
————————– EXEMPEL 3 ————————–
PS C:\>new-item -path $profile -itemtype file -force
Det här kommandot skapar en Windows PowerShell-profil i den sökväg som anges av variabeln $profile.
Du kan använda profiler för att anpassa Windows PowerShell. $Profile är en automatisk (inbyggd) variabel som lagrar sökvägen och filnamnet för CurrentUser/CurrentHost-profilen. som standard finns profilen inte, även om Windows PowerShell lagrar en sökväg och ett filnamn för den.
I det här kommandot representerar variabeln $profile sökvägen till filen. parametern ItemType anger att kommandot skapar en fil. med parametern Force kan du skapa en fil i profilsökvägen, även om katalogerna i sökvägen inte finns (Windows PowerShell skapar dem).
När du har använt det här kommandot för att skapa en profil kan du ange alias, funktioner och skript i profilen för att anpassa ditt skal.
Mer information finns i about_Automatic_Variables och about_Profiles.
————————– EXEMPEL 4 ————————–
PS C:\>new-item -itemtype directory -path c:\ps-test\scripts
Det här kommandot skapar en ny katalog Scripts i katalogen C:\PS-Test.
Namnet på det nya katalogobjektet, Scripts, ingår i värdet på Path-parametern i stället för att anges i värdet på Name-parametern.Som framgår av syntaxen är båda kommandovarorna giltiga.
————————– EXEMPEL 5 ————————–
PS C:\>new-item -itemtype file -path "c:\ps-test\test.txt", "c:\ps-test\Logs\test.log"
I det här kommandot används cmdlet New-Item för att skapa filer i två olika kataloger.Eftersom Path-parametern tar emot flera strängar kan du använda den för att skapa flera objekt.
Obligatoriska parametrar
Anger namnet på det nya objektet.
Du kan ange namnet på det nya objektet i parametervärdet Namn eller Sökväg och du kan ange sökvägen till det nya objektet i parametervärdet Namn eller Sökväg.
Typ: | String |
Position: | Namngiven |
Standardvärde: | Ingen |
Accepterar inmatning från pipeline: | True (ByPropertyName) |
Acceptera jokertecken: | Falsk |
Anger sökvägen till platsen för det nya objektet.
Du kan ange namnet på det nya objektet i parametern Name eller inkludera det i parametern Path.
Typ: | String |
Position: | 1 |
Standardvärde: | Ingen |
Accepterar inmatning från pipeline: | True (ByPropertyName) |
Acceptera jokertecken: | Falsk |
Valfria parametrar
Uppmanar dig att bekräfta innan du kör cmdlet.Uppmanar dig att bekräfta innan du kör cmdlet.
Typ: | SwitchParameter |
Alias: | cf |
Position: | Named |
Standardvärde: | Falsk |
Accepterar inmatning från pipeline: | Falsk |
Accepterar jokertecken: | Falsk |
Anger ett användarkonto som har behörighet att utföra den här åtgärden.Standardvärdet är den aktuella användaren.
Ange ett användarnamn, t.ex. ”User01” eller ”Domain01\User01”, eller ange ett PSCredential-objekt, t.ex. ett som genereras av cmdlet Get-Credential.Om du anger ett användarnamn uppmanas du att ange ett lösenord.
Den här parametern stöds inte av leverantörer som installerats med Windows PowerShell
Typ: | PSCredential |
Position: | Named |
Standardvärde: | Ingen |
Accepterar inmatning från pipeline: | True (ByPropertyName) |
Acceptera jokertecken: | Falsk |
Gör det möjligt för cmdlet att skapa ett objekt som skriver över ett befintligt skrivskyddat objekt.Implementationen varierar från leverantör till leverantör.Mer information finns i about_Providers.Även om du använder Force-parametern kan cmdlet inte åsidosätta säkerhetsbegränsningar.
Typ: | SwitchParameter |
Position: | Namngiven |
Standardvärde: | Ingen |
Accepterar pipeline input: | Falsk |
Accepterar jokertecken: | Falsk |
Inkluderar kommandot i den aktiva transaktionen.Den här parametern är endast giltig när en transaktion pågår.För mer information, se Inkluderar kommandot i den aktiva transaktionen.Den här parametern är endast giltig när en transaktion pågår.För mer information, se
Typ: | SwitchParameter |
Alias: | usetx |
Position: | Namn |
Standardvärde: | Falsk |
Accepterar inmatning från pipeline: | Falsk |
Accepterar jokertecken: | Falskt |
Anger värdet för det nya objektet.Du kan också överföra ett värde till New-Item.
Typ: | Objekt |
Position: | Namngiven |
Standardvärde: | Ingen |
Accepterar inmatning från pipeline: | True (ByPropertyName, ByValue) |
Acceptera jokertecken: | Falsk |
Visar vad som skulle hända om cmdlet körs.cmdlet körs inte.
Typ: | SwitchParameter |
Alias: | wi |
Position: | Named |
Standardvärde: | Falsk |
Accepterar inmatning från pipeline: | Falsk |
Accepterar jokertecken: | Falskt |
Inmatningar
System.Object
Du kan överföra ett värde för det nya objektet till cmdlet New-Item.
Utdata
System.Object
New-Item returnerar det objekt som skapas.
Anteckningar
Cmdletten New-Item är utformad för att arbeta med data som exponeras av en provider.Om du vill se en lista över de providers som är tillgängliga i din session skriver du ”Get-PsProvider”.För mer information, se about_Providers.
- Clear-Item
- Copy-Item
- Get-Item
- Invoke-Item
- Move-Item
- Remove-Item
- Rename-Item
- Set-Item
- about_Providers
.