New-Item
Skapar ett nytt objekt.
Syntax
New-Item
[-Path] <String[]>
[-ItemType <String>]
[-Value <Object>]
[-Force]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-Item
[[-Path] <String[]>]
-Name <String>
[-ItemType <String>]
[-Value <Object>]
[-Force]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Cmdleten New-Item
skapar ett nytt objekt och anger dess värde. Vilka typer av objekt som kan skapas beror på objektets plats. I filsystemet New-Item
skapar du till exempel filer och mappar. I registret New-Item
skapar du registernycklar och poster.
New-Item
kan också ange värdet för de objekt som skapas. När den till exempel skapar en ny fil New-Item
kan du lägga till initialt innehåll i filen.
Exempel
Exempel 1: Skapa en fil i den aktuella katalogen
Det här kommandot skapar en textfil med namnet "testfile1.txt" i den aktuella katalogen. Punkten ('.') i värdet för parametern Path anger den aktuella katalogen. Den citerade texten som följer parametern Value läggs till i filen som innehåll.
New-Item -Path . -Name "testfile1.txt" -ItemType "file" -Value "This is a text string."
Exempel 2: Skapa en katalog
Det här kommandot skapar en katalog med namnet "Logfiles" på C:
enheten. Parametern ItemType anger att det nya objektet är en katalog, inte en fil eller något annat filsystemobjekt.
New-Item -Path "c:\" -Name "logfiles" -ItemType "directory"
Exempel 3: Skapa en profil
Det här kommandot skapar en PowerShell-profil i sökvägen som anges av variabeln $profile
.
Du kan använda profiler för att anpassa PowerShell. $profile
är en automatisk (inbyggd) variabel som lagrar sökvägen och filnamnet för profilen "CurrentUser/CurrentHost". Profilen finns som standard inte, även om 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. ItemType-parametern 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.
När du har skapat en profil kan du ange alias, funktioner och skript i profilen för att anpassa gränssnittet.
Mer information finns i about_Automatic_Variables och about_Profiles.
New-Item -Path $profile -ItemType "file" -Force
Exempel 4: Skapa en katalog i en annan katalog
Det här exemplet skapar en ny skriptkatalog i katalogen "C:\PS-Test".
Namnet på det nya katalogobjektet , "Scripts", ingår i värdet för Path-parametern , i stället för att anges i värdet för Namn. Som syntaxen anger är antingen kommandoformuläret giltigt.
New-Item -ItemType "directory" -Path "c:\ps-test\scripts"
Exempel 5: Skapa flera filer
Det här exemplet skapar filer i två olika kataloger. Eftersom Sökvägen tar flera strängar kan du använda den för att skapa flera objekt.
New-Item -ItemType "file" -Path "c:\ps-test\test.txt", "c:\ps-test\Logs\test.log"
Exempel 6: Använd jokertecken för att skapa filer i flera kataloger
Cmdleten New-Item
stöder jokertecken i parametern Path . Följande kommando skapar en temp.txt
fil i alla kataloger som anges av jokertecken i parametern Sökväg .
Get-ChildItem -Path C:\Temp\
Directory: C:\Temp
Mode LastWriteTime Length Name
---- ------------- ------ ----
d----- 5/15/2019 6:45 AM 1 One
d----- 5/15/2019 6:45 AM 1 Two
d----- 5/15/2019 6:45 AM 1 Three
New-Item -Path C:\Temp\* -Name temp.txt -ItemType File | Select-Object FullName
FullName
--------
C:\Temp\One\temp.txt
C:\Temp\Three\temp.txt
C:\Temp\Two\temp.txt
Cmdleten Get-ChildItem
visar tre kataloger under C:\Temp
katalogen. Med jokertecken skapar cmdleten New-Item
en temp.txt
fil i alla kataloger under den aktuella katalogen. Cmdleten New-Item
matar ut de objekt som du skapade, som skickas till för att verifiera sökvägarna för Select-Object
de nyligen skapade filerna.
Exempel 7: Skapa en symbolisk länk till en fil eller mapp
Det här exemplet skapar en symbolisk länk till filen Notice.txt i den aktuella mappen.
$link = New-Item -ItemType SymbolicLink -Path .\link -Target .\Notice.txt
$link | Select-Object LinkType, Target
LinkType Target
-------- ------
SymbolicLink {.\Notice.txt}
I det här exemplet är Target ett alias för parametern Value . Målet för den symboliska länken kan vara en relativ sökväg. Före PowerShell v6.2 måste målet vara en fullständigt kvalificerad sökväg.
Från och med PowerShell 7.1 kan du nu skapa till en SymbolicLink till en mapp i Windows med hjälp av en relativ sökväg.
Exempel 8: Använd parametern -Force för att försöka återskapa mappar
Det här exemplet skapar en mapp med en fil inuti. Försöker sedan skapa samma mapp med hjälp av -Force
. Den skriver inte över mappen utan returnerar bara det befintliga mappobjektet med filen som skapats intakt.
PS> New-Item -Path .\TestFolder -ItemType Directory
PS> New-Item -Path .\TestFolder\TestFile.txt -ItemType File
PS> New-Item -Path .\TestFolder -ItemType Directory -Force
Directory: C:\
Mode LastWriteTime Length Name
---- ------------- ------ ----
d----- 5/1/2020 8:03 AM TestFolder
PS> Get-ChildItem .\TestFolder\
Directory: C:\TestFolder
Mode LastWriteTime Length Name
---- ------------- ------ ----
-a---- 5/1/2020 8:03 AM 0 TestFile.txt
Exempel 9: Använd parametern -Force för att skriva över befintliga filer
Det här exemplet skapar en fil med ett värde och återskapar sedan filen med .-Force
Detta skriver över den befintliga filen och den förlorar innehållet som du kan se med egenskapen length
PS> New-Item ./TestFile.txt -ItemType File -Value 'This is just a test file'
Directory: C:\Source\Test
Mode LastWriteTime Length Name
---- ------------- ------ ----
-a---- 5/1/2020 8:32 AM 24 TestFile.txt
New-Item ./TestFile.txt -ItemType File -Force
Directory: C:\Source\Test
Mode LastWriteTime Length Name
---- ------------- ------ ----
-a---- 5/1/2020 8:32 AM 0 TestFile.txt
Anteckning
När du använder New-Item
med växeln -Force
för att skapa registernycklar fungerar kommandot på samma sätt som när du skriver över en fil. Om registernyckeln redan finns skrivs nyckeln och alla egenskaper och värden över med en tom registernyckel.
Parametrar
-Confirm
Uppmanar dig att bekräfta innan du kör cmdleten.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Credential
Anteckning
Den här parametern stöds inte av några leverantörer som är installerade med PowerShell. Om du vill personifiera en annan användare eller höja dina autentiseringsuppgifter när du kör den här cmdleten använder du Invoke-Command
.
Type: | PSCredential |
Position: | Named |
Default value: | Current user |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Force
Tvingar den här cmdleten att skapa ett objekt som skriver över ett befintligt skrivskyddat objekt. Implementeringen varierar från leverantör till leverantör. Även om du använder force-parametern kan cmdleten inte åsidosätta säkerhetsbegränsningar.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ItemType
Anger den providerspecifika typen av det nya objektet. Vilka värden som är tillgängliga för den här parametern beror på den aktuella providern som du använder.
Om din plats finns på en FileSystem
enhet tillåts följande värden:
- Fil
- Katalog
- Symbolisk länk
- Knutpunkt
- Hardlink
Anteckning
För att skapa en SymbolicLink
typ i Windows krävs utökade privilegier som administratör. Men Windows 10 (version 14972 eller senare) med utvecklarläge aktiverat kräver inte längre utökade symboliska länkar.
På en Certificate
enhet är det här de värden som du kan ange:
- Certifikatprovider
- Certifikat
- Lagringsplats
- StoreLocation
Mer information finns i about_Providers.
Type: | String |
Aliases: | Type |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
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 namn - eller sökvägsvärdet . Objektnamn som skickas med parametern Namn skapas i förhållande till värdet för parametern Path .
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Path
Anger sökvägen till platsen för det nya objektet. Standardinställningen är den aktuella platsen när sökvägen utelämnas. Du kan ange namnet på det nya objektet i Namn eller inkludera det i Sökväg. Objektnamn som skickas med parametern Namn skapas i förhållande till värdet för parametern Path .
För den här cmdleten fungerar parametern Path som parametern LiteralPath för andra cmdletar.
Jokertecken tolkas inte. Alla tecken skickas till platsens provider. Providern kanske inte stöder alla tecken. Du kan till exempel inte skapa ett filnamn som innehåller ett asterisktecken (*
).
Type: | String[] |
Position: | 0 |
Default value: | Current location |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Value
Anger värdet för det nya objektet. Du kan också skicka ett värde till New-Item
.
Type: | Object |
Aliases: | Target |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WhatIf
Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Indata
Du kan skicka ett värde för det nya objektet till den här cmdleten.
Utdata
Den här cmdleten returnerar det objekt som den skapar.
Kommentarer
New-Item
är utformat för att fungera med data som exponeras av alla leverantörer. Om du vill visa en lista över de leverantörer som är tillgängliga i sessionen skriver du Get-PsProvider
. Mer information finns i about_Providers.