New-Item

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>]

New-Item
    [-Path] <string[]>
    -ConnectionURI <uri>
    [-ItemType <string>]
    [-Value <Object>]
    [-Force]
    [-Credential <pscredential>]
    [-WhatIf]
    [-Confirm]
    [-OptionSet <hashtable>]
    [-Authentication <AuthenticationMechanism>]
    [-CertificateThumbprint <string>]
    [-SessionOption <SessionOption>]
    [-Port <int>]
    [<CommonParameters>]

New-Item
    [[-Path] <string[]>]
    -Name <string>
    [-ItemType <string>]
    [-Value <Object>]
    [-Force]
    [-Credential <pscredential>]
    [-WhatIf]
    [-Confirm]
    [-OptionSet <hashtable>]
    [-Authentication <AuthenticationMechanism>]
    [-CertificateThumbprint <string>]
    [-SessionOption <SessionOption>]
    [-ApplicationName <string>]
    [-Port <int>]
    [-UseSSL]
    [<CommonParameters>]

New-Item
    [-Path] <string[]>
    [-ItemType <string>]
    [-Value <Object>]
    [-Force]
    [-Credential <pscredential>]
    [-WhatIf]
    [-Confirm]
    [-Options <ScopedItemOptions>]
    [<CommonParameters>]

New-Item
    [[-Path] <string[]>]
    -Name <string>
    [-ItemType <string>]
    [-Value <Object>]
    [-Force]
    [-Credential <pscredential>]
    [-WhatIf]
    [-Confirm]
    [-Options <ScopedItemOptions>]
    [<CommonParameters>]

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 skapar New-Item till exempel filer och mappar. I registret skapar New-Item 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 kan New-Item lägga till initialt innehåll i filen.

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."

Det här kommandot skapar en katalog med namnet "Logfiles" på den C: enheten. Parametern ItemType anger att det nya objektet är en katalog, inte en fil eller ett annat filsystemobjekt.

New-Item -Path "C:\" -Name "Logfiles" -ItemType "Directory"

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. 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.

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

Det här exemplet skapar en ny skriptkatalog i katalogen "C:\PS-Test".

Namnet på det nya katalogobjektet "Skript" ingår i värdet för parametern Path i stället för att anges i värdet för Name. Som syntaxen anger är antingen kommandoformuläret giltigt.

New-Item -ItemType "Directory" -Path "C:\ps-test\scripts"

Det här exemplet skapar filer i två olika kataloger. Eftersom Path 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"

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 Path.

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 katalogen C:\Temp. 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 Select-Object för att verifiera sökvägarna för de nyligen skapade filerna.

I det här exemplet skapas 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.

I det här exemplet skapas 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

Det här exemplet skapar en fil med ett värde och återskapar sedan filen med parametern Force. Detta skriver över den befintliga filen, 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

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

Du kan skicka ett värde för det nya objektet till den här cmdleten.

Cmdleten returnerar ett DictionaryEntry-objekt när du skapar en ny miljövariabel.

Cmdleten returnerar ett DirectoryInfo--objekt när du skapar en ny katalog i filsystemet.

Cmdleten returnerar ett FileInfo--objekt när du skapar en ny fil i filsystemet.

Cmdleten returnerar ett AliasInfo--objekt när du skapar ett nytt alias.

Cmdleten returnerar ett FunctionInfo--objekt när du skapar en ny funktion.

Cmdleten returnerar ett PSVariable--objekt när du skapar en ny variabel.

PowerShell innehåller följande alias för New-Item:

• Alla plattformar:
  • ni

New-Item är utformat för att fungera med data som exponeras av alla leverantörer. Om du vill visa en lista över tillgängliga leverantörer i sessionen skriver du Get-PSProvider. Mer information finns i om_Leverantörer.