New-Item

Modul:

Microsoft.PowerShell.Management Module

Vytvoří novou položku.

Syntaxe

pathSet (Default) - All providers

New-Item
    [-Path] <String[]>
    [-ItemType <String>]
    [-Value <Object>]
    [-Force]
    [-Credential <PSCredential>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

nameSet - All providers

New-Item
    [[-Path] <String[]>]
    -Name <String>
    [-ItemType <String>]
    [-Value <Object>]
    [-Force]
    [-Credential <PSCredential>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

pathSet (Default) - WSMan provider

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

nameSet - WSMan provider

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

pathSet (Default) - Alias provider

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

nameSet - Alias provider

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

Description

Rutina New-Item vytvoří novou položku a nastaví její hodnotu. Typy položek, které lze vytvořit, závisí na umístění položky. Například v systému souborů New-Item vytváří soubory a složky. V registru New-Item vytvoří klíče registru a položky.

New-Item může také nastavit hodnotu položek, které vytvoří. Když například vytvoří nový soubor, New-Item může do souboru přidat počáteční obsah.

Příklady

Příklad 1: Vytvoření souboru v aktuálním adresáři

Tento příkaz vytvoří textový soubor s názvem "testfile1.txt" v aktuálním adresáři. Tečka (.) v hodnotě parametru Path označuje aktuální adresář. Text, který následuje za parametrem Value, se přidá do souboru jako obsah.

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

Příklad 2: Vytvoření adresáře

Tento příkaz vytvoří adresář s názvem Logfiles na jednotce C:. Parametr ItemType určuje, že nová položka je adresář, nikoli soubor nebo jiný objekt systému souborů.

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

Příklad 3: Vytvoření profilu

Tento příkaz vytvoří profil PowerShellu v cestě určené proměnnou $PROFILE.

K přizpůsobení PowerShellu můžete použít profily. $PROFILE je automatická (integrovaná) proměnná, která ukládá cestu a název souboru profilu CurrentUser/CurrentHost. Ve výchozím nastavení profil neexistuje, i když PowerShell uloží cestu a název souboru.

V tomto příkazu $PROFILE proměnná představuje cestu k souboru. ItemType parametr určuje, že příkaz vytvoří soubor. Parametr Force umožňuje vytvořit soubor v cestě profilu, i když adresáře v cestě neexistují.

Po vytvoření profilu můžete do profilu zadat aliasy, funkce a skripty pro přizpůsobení prostředí.

Další informace najdete v tématu about_Automatic_Variables a about_Profiles.

New-Item -Path $PROFILE -ItemType "File" -Force

Příklad 4: Vytvoření adresáře v jiném adresáři

Tento příklad vytvoří nový adresář Scripts v adresáři C:\PS-Test.

Název nové položky adresáře "Scripts" je součástí hodnoty parametru Path místo zadání v hodnotě Name. Jak je uvedeno v syntaxi, je platný formulář příkazu.

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

Příklad 5: Vytvoření více souborů

Tento příklad vytvoří soubory ve dvou různých adresářích. Protože Cesta přebírá více řetězců, můžete ji použít k vytvoření více položek.

New-Item -ItemType "File" -Path "C:\ps-test\test.txt", "C:\ps-test\Logs\test.log"

Příklad 6: Použití zástupných znaků k vytvoření souborů v několika adresářích

Rutina New-Item podporuje zástupné cardy v parametru Path. Následující příkaz vytvoří soubor temp.txt ve všech adresářích určených zástupnými cardy v parametru 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

Rutina Get-ChildItem zobrazuje tři adresáře v adresáři C:\Temp. Pomocí zástupných znaků vytvoří rutina New-Item soubor temp.txt ve všech adresářích v aktuálním adresáři. Rutina New-Item výstupem položek, které jste vytvořili, se předá Select-Object k ověření cest k nově vytvořeným souborům.

Příklad 7: Vytvoření symbolického odkazu na soubor nebo složku

Tento příklad vytvoří symbolický odkaz na soubor Notice.txt v aktuální složce.

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

LinkType     Target
--------     ------
SymbolicLink {.\Notice.txt}

V tomto příkladu Target je alias parametru Value. Cílem symbolického odkazu může být relativní cesta. Před PowerShellem v6.2 musí být cílem plně kvalifikovaná cesta.

Počínaje PowerShellem 7.1 teď můžete vytvořit symbolický odkaz do složky ve Windows pomocí relativní cesty.

Příklad 8: Použití parametru -Force k pokusu o opětovné vytvoření složek

Tento příklad vytvoří složku se souborem uvnitř. Potom se pokusí vytvořit stejnou složku pomocí -Force. Nepřepíše složku, ale jednoduše vrátí existující objekt složky se souborem vytvořeným beze změny.

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

Příklad 9: Použití parametru Force k přepsání existujících souborů

Tento příklad vytvoří soubor s hodnotou a pak ho znovu vytvoří pomocí parametru Force. Tím se stávající soubor přepíše, jak vidíte pomocí vlastnosti 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

Poznámka:

Při použití New-Item s parametrem Force k vytvoření klíčů registru se příkaz chová stejně jako při přepsání souboru. Pokud klíč registru již existuje, klíč a všechny vlastnosti a hodnoty se přepíšou prázdným klíčem registru.

Parametry

-ApplicationName

Jedná se o dynamický parametr zpřístupněný poskytovatelem WSMan. Poskytovatel WSMan a tento parametr jsou k dispozici pouze ve Windows.

Určuje název aplikace v připojení. Výchozí hodnota parametru ApplicationName je WSMAN.

Další informace naleznete v tématu New-WSManInstance.

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

nameSet

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Authentication

Jedná se o dynamický parametr zpřístupněný poskytovatelem WSMan. Poskytovatel WSMan a tento parametr jsou k dispozici pouze ve Windows.

Určuje mechanismus ověřování, který se má použít na serveru.

Další informace naleznete v tématu New-WSManInstance.

Vlastnosti parametru

Typ:	AuthenticationMechanism
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-CertificateThumbprint

Jedná se o dynamický parametr zpřístupněný poskytovatelem WSMan. Poskytovatel WSMan a tento parametr jsou k dispozici pouze ve Windows.

Určuje certifikát digitálního veřejného klíče (X509) uživatelského účtu, který má oprávnění k provedení této akce WSMan. Zadejte kryptografický otisk certifikátu.

Další informace naleznete v tématu New-WSManInstance.

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Confirm

Před spuštěním cmdletu vás vyzve k potvrzení.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	False
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	viz

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-ConnectionURI

Jedná se o dynamický parametr zpřístupněný poskytovatelem WSMan. Poskytovatel WSMan a tento parametr jsou k dispozici pouze ve Windows.

Určuje koncový bod připojení pro WSMan.

Další informace naleznete v tématu New-WSManInstance.

Vlastnosti parametru

Typ:	Uri
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

pathSet

Position:	Named
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Credential

Poznámka:

Tento parametr nejsou podporovány žádnými poskytovateli nainstalovanými v PowerShellu. Pokud chcete při spuštění této rutiny zosobnit jiného uživatele nebo zvýšit oprávnění, použijte Invoke-Command.

Vlastnosti parametru

Typ:	PSCredential
Default value:	Current user
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-Force

Vynutí tuto rutinu, aby vytvořila položku, která zapisuje existující položku jen pro čtení. Implementace se liší od zprostředkovatele po zprostředkovatele. I když používáte parametr Force, rutina nemůže přepsat omezení zabezpečení.

Počínaje PowerShellem 7.4 tento parametr také umožňuje přepsat existující spojení. Dříve se to nepovede s chybou "nelze odebrat, protože není prázdná".

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-ItemType

Určuje typ nové položky zadaný zprostředkovatelem. Dostupné hodnoty tohoto parametru závisí na aktuálním poskytovateli, který používáte.

Pokud je vaše umístění na jednotce FileSystem, jsou povoleny následující hodnoty:

• File
• Directory
• SymbolicLink
• Junction
• HardLink

Poznámka:

Vytvoření typu SymbolicLink ve Windows vyžaduje zvýšení oprávnění jako správce. Windows 10 (build 14972 nebo novější) s povoleným režimem vývojáře už ale nevyžaduje zvýšení oprávnění vytvářet symbolické odkazy.

V jednotce Certificate můžete zadat tyto hodnoty:

• Certificate Provider
• Certificate
• Store
• StoreLocation

Další informace naleznete v tématu about_Providers.

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	Typ

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-Name

Určuje název nové položky. Název nové položky můžete zadat v Name nebo Path hodnotu parametru a můžete zadat cestu nové položky v Name nebo Path hodnotu. Názvy položek předané pomocí parametru Name se vytvoří vzhledem k hodnotě parametru Path.

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

nameSet

Position:	Named
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-Options

Jedná se o dynamický parametr zpřístupněný poskytovatelem aliasu. Další informace najdete v tématu New-Alias .

Určuje hodnotu vlastnosti Options aliasu.

Platné hodnoty jsou:

• None: Alias nemá žádná omezení (výchozí hodnota)
• ReadOnly: Alias je možné odstranit, ale nejde ho změnit bez použití parametru Force
• Constant: Alias nejde odstranit ani změnit
• Private: Alias je k dispozici pouze v aktuálním rozsahu.
• AllScope: Alias se kopíruje do jakýchkoli nově vytvořených oborů.
• Unspecified: Možnost není zadána.

Vlastnosti parametru

Typ:	ScopedItemOptions
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-OptionSet

Jedná se o dynamický parametr zpřístupněný poskytovatelem WSMan. Poskytovatel WSMan a tento parametr jsou k dispozici pouze ve Windows.

Předá sadu přepínačů službě, která upraví nebo upřesní povahu požadavku.

Další informace naleznete v tématu New-WSManInstance.

Vlastnosti parametru

Typ:	Hashtable
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	operační systém

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Path

Určuje cestu umístění nové položky. Výchozí hodnota je aktuální umístění, pokud cesta vynechá. Název nové položky můžete zadat v Názevnebo jej zahrnout do Cesta. Názvy položek předané pomocí parametru Name se vytvoří vzhledem k hodnotě parametru Path.

Pro tuto rutinu funguje parametr Path jako parametr LiteralPath jiných rutin. Zástupné znaky nejsou interpretovány. Všechny znaky se předávají poskytovateli umístění. Zprostředkovatel nemusí podporovat všechny znaky. Nemůžete například vytvořit název souboru, který obsahuje znak hvězdičky (*).

Vlastnosti parametru

Typ:	String[]
Default value:	Current location
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

pathSet

Position:	0
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

nameSet

Position:	0
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-Port

Jedná se o dynamický parametr zpřístupněný poskytovatelem WSMan. Poskytovatel WSMan a tento parametr jsou k dispozici pouze ve Windows.

Určuje port, který se má použít, když se klient připojí ke službě WinRM.

Další informace naleznete v tématu New-WSManInstance.

Vlastnosti parametru

Typ:	Int32
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-SessionOption

Jedná se o dynamický parametr zpřístupněný poskytovatelem WSMan. Poskytovatel WSMan a tento parametr jsou k dispozici pouze ve Windows.

Definuje sadu rozšířených možností pro relaci WS-Management.

Další informace naleznete v tématu New-WSManInstance.

Vlastnosti parametru

Typ:	SessionOption
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	TAKŽE

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-UseSSL

Jedná se o dynamický parametr zpřístupněný poskytovatelem WSMan. Poskytovatel WSMan a tento parametr jsou k dispozici pouze ve Windows.

Určuje, že protokol SSL (Secure Sockets Layer) by se měl použít k navázání připojení ke vzdálenému počítači. Ve výchozím nastavení se ssl nepoužívá.

Další informace naleznete v tématu New-WSManInstance.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

nameSet

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Value

Určuje hodnotu nové položky. Hodnotu můžete také pipetovat do New-Item.

Vlastnosti parametru

Typ:	Object
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	Cíl

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	True
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-WhatIf

Ukazuje, co se stane, když se příkaz spustí. Cmdlet se nespustil.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	False
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	Wi

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

CommonParameters

Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.

Vstupy

Object

Do této rutiny můžete přidat hodnotu nové položky.

Výstupy

DictionaryEntry

Rutina vrátí objekt DictionaryEntry při vytváření nové proměnné prostředí.

DirectoryInfo

Rutina vrátí objekt DirectoryInfo při vytváření nového adresáře v systému souborů.

FileInfo

Rutina vrátí objekt FileInfo při vytváření nového souboru v systému souborů.

AliasInfo

Rutina při vytváření nového aliasu vrátí objekt AliasInfo.

FunctionInfo

Rutina při vytváření nové funkce vrátí objekt FunctionInfo.

PSVariable

Rutina při vytváření nové proměnné vrátí objekt PSVariable.

Poznámky

PowerShell obsahuje následující aliasy pro New-Item:

• Všechny platformy:
  • ni

New-Item je navržená tak, aby fungovala s daty vystavenými libovolným poskytovatelem. Chcete-li zobrazit seznam poskytovatelů dostupných ve vaší relaci, napište Get-PSProvider. Pro více informací viz about_Providers.

Související odkazy

• Vymazat položku
• Kopírovat položku
• Get-Item
• Invoke-Item
• Přesunout položku
• Odstranit položku
• Přejmenovat položku
• Set-Item
• O poskytovatelích