New-Item

Modul: Microsoft.PowerShell.Management

Syntaks

New-Item <String> 

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

Beskrivelse

Cmdletten New-Item opretter et nyt element og fastsætter dets værdi. De typer af elementer, der kan oprettes, afhænger af elementets placering. I filsystemet opretter New-Item f.eks. filer og mapper. I registreringsdatabasen opretter New-Item registreringsdatabasenøgler og poster.

New-Item kan også angive værdien af de elementer, som den opretter. Når den f.eks. opretter en ny fil, kan New-Item tilføje indledende indhold til filen.

Eksempler

Eksempel 1: Opret en fil i den aktuelle mappe

Denne kommando opretter en tekstfil, der hedder “testfile1.txt”, i den aktuelle mappe. Punktet(‘.’) i værdien af Path-parameteren angiver den aktuelle mappe. Den tekst i anførselstegn, der følger efter parameteren Value, tilføjes til filen som indhold.

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

Eksempel 2: Opret en mappe

Denne kommando opretter en mappe med navnet “Logfiles” i drevet C:. Parameteren ItemType angiver, at det nye element er en mappe og ikke en fil eller et andet filsystemobjekt.

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

Eksempel 3: Opret en profil

Denne kommando opretter en PowerShell-profil i den sti, der er angivet af variablen $profile.

Du kan bruge profiler til at tilpasse PowerShell. $profile er en automatisk (indbygget) variabel, der gemmer stien og filnavnet for profilen “CurrentUser/CurrentHost”. Som standard findes profilen ikke, selv om PowerShell gemmer en sti og et filnavn for den.

I denne kommando repræsenterer $profile-variablen stien til filen. Parameteren ItemType angiver, at kommandoen opretter en fil. Med parameteren Force kan du oprette en fil i profilstien, selv når mapperne i stien ikke findes.

Når du har oprettet en profil, kan du indtaste aliaser, funktioner og scripts i profilen for at tilpasse din shell.

Fors yderligere oplysninger kan du se about_Automatic_Variablesog about_Profiles.

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

Eksempel 4: Opret en mappe i en anden mappe

Dette eksempel opretter en ny mappe Scripts i mappen “C:\PS-Test”.

Navnet på det nye mappeelement, “Scripts”, er inkluderet i værdien af Path-parameteren,i stedet for at være angivet i værdien af Name. Som det fremgår af syntaksen, er begge kommando-former gyldige.

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

Eksempel 5: Opret flere filer

Dette eksempel opretter filer i to forskellige mapper. Da Path tager flere strenge, kan du bruge den til at oprette flere elementer.

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

Eksempel 6: Brug jokertegn til at oprette filer i flere mapper

Cmdlet New-Item understøtter jokertegn i Path-parameteren. Følgende kommando opretter entemp.txt-fil i alle de mapper, der er angivet med jokertegn i Path-parameteren.

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

Cmdletten Get-ChildItem viser tre mapper under mappen C:\Temp. Ved hjælp af jokertegn opretter cmdletten New-Item en temp.txt-fil i alle mapper under den aktuelle mappe. Cmdletten New-Item udsender de elementer, du har oprettet, som ledes til Select-Objectfor at verificere stierne for de nyoprettede filer.

Eksempel 7: Opret et symbolsk link til en fil eller mappe

Dette eksempel opretter et symbolsk link til filen Notice.txt i den aktuelle mappe.

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

I dette eksempel er Target et alias for parameteren Value. Målet for det symbolske linkkan være en relativ sti. Før PowerShell v6.2 skal målet være en fuldt kvalificeret sti.

Med start i PowerShell 7.1 kan du nu oprette et symbolsk link til en mappe i Windows ved hjælp af en relativ sti.

Eksempel 8: Brug parameteren -Force til at forsøge at genskabe mapper

Dette eksempel opretter en mappe med en fil indeni. Derefter forsøges det at oprette den samme mappe ved hjælp af-Force. Den vil ikke overskrive mappen, men blot returnere det eksisterende mappeobjekt med den oprettede fil intakt.

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

Eksempel 9: Brug parameteren -Force til at overskrive eksisterende filer

Dette eksempel opretter en fil med en værdi og genskaber derefter filen ved hjælp af -Force. Dette overskriverDen eksisterende fil, og den mister sit indhold, som du kan se af længdeegenskaben

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

Parametre