Dela via

New-Item

  • Referens
Modul:
Microsoft.PowerShell.Management

Skapar ett nytt objekt.

Syntax

New-Item
   [-Path] <String[]>
   [-ItemType <String>]
   [-Value <Object>]
   [-Force]
   [-Credential <PSCredential>]
   [-WhatIf]
   [-Confirm]
   [-UseTransaction]
   [<CommonParameters>]
New-Item
   [[-Path] <String[]>]
   -Name <String>
   [-ItemType <String>]
   [-Value <Object>]
   [-Force]
   [-Credential <PSCredential>]
   [-WhatIf]
   [-Confirm]
   [-UseTransaction]
   [<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 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.

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

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

Not

När du skapar en fil med den här metoden kodas den resulterande filen som UTF-8 utan byte-order-mark (BOM).

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

Exempel 5: Skapa flera filer

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"

Parametrar

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Typ:SwitchParameter
Alias:cf
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Credential

Not

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.

Typ:PSCredential
Position:Named
Standardvärde:Current user
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken: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. Mer information finns i about_Providers. Även om du använder parametern Force kan cmdleten inte åsidosätta säkerhetsbegränsningar.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken: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

När du skapar en fil med den här metoden kodas den resulterande filen som UTF-8 utan byte-order-mark (BOM).

I en Certificate enhet är det här de värden som du kan ange:

  • Certifikatprovider
  • Intyg
  • Butik
  • StoreLocation

Mer information finns i about_Providers.

Typ:String
Alias:Type
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Name

Anger namnet på det nya objektet.

Du kan ange namnet på det nya objektet i parametervärdet Name eller Path och du kan ange sökvägen till det nya objektet i Name eller Path value.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Path

Anger sökvägen till platsen för det nya objektet. Jokertecken tillåts.

Du kan ange namnet på det nya objektet i Namn, eller inkludera det i Sökväg.

Typ:String[]
Position:0
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:True

-UseTransaction

Innehåller kommandot i den aktiva transaktionen. Den här parametern är endast giltig när en transaktion pågår. Mer information finns i about_Transactions.

Typ:SwitchParameter
Alias:usetx
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Value

Anger värdet för det nya objektet. Du kan också skicka ett värde för att New-Item.

Typ:Object
Alias:Target
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-WhatIf

Visar vad som skulle hända om cmdleten körs. Cmdleten körs inte.

Typ:SwitchParameter
Alias:wi
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Indata

Object

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

Utdata

Object

Den här cmdleten returnerar det objekt som skapas.

Kommentarer

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