Syntaxe
mkdir <String>
mkdir <String>] -Name <String>
Popis
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ů se rutina New-Item používá k vytváření souborů a složek. v registru rutina New-Item vytváří klíče a položky registru.
New-Item může také nastavit hodnotu položek, které vytváří. například při vytváření nového souboru může New-Item přidat do souboru počáteční obsah.
Příklady
————————– PŘÍKLAD 1 ————————–
PS C:\>new-item -path . -name testfile1.txt -itemtype "file" -value "This is a text string."
Tento příkaz vytvoří v aktuálním adresáři textový soubor s názvem testfile1.txt. tečka (.) v hodnotě parametru Path označuje aktuální adresář. text v uvozovkách, který následuje za parametrem Value, se přidá do souboru jako obsah.
————————– PŘÍKLAD 2 ————————–
PS C:\>new-item -path c:\ -name logfiles -itemtype directory
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 souborového systému.
————————– PŘÍKLAD 3 ————————–
PS C:\>new-item -path $profile -itemtype file -force
Tento příkaz vytvoří profil prostředí Windows PowerShell v cestě, která je zadána proměnnou $profile.
Profily můžete použít k přizpůsobení prostředí Windows PowerShell. $Profile je automatická (vestavěná) proměnná, která ukládá cestu a název souboru profilu CurrentUser/CurrentHost. ve výchozím nastavení profil neexistuje, přestože prostředí Windows PowerShell pro něj ukládá cestu a název souboru.
V tomto příkazu představuje proměnná $profile cestu k souboru. parametr ItemType určuje, že příkaz vytvoří soubor. parametr Force umožňuje vytvořit soubor v cestě k profilu, i když adresáře v cestě neexistují (prostředí Windows PowerShell je vytvoří).
Po použití tohoto příkazu k vytvoření profilu můžete do profilu zadat aliasy, funkce a skripty a přizpůsobit si tak svůj shell.
Další informace naleznete v části about_Automatic_Variables a about_Profiles.
————————– PŘÍKLAD 4 ————————–
PS C:\>new-item -itemtype directory -path c:\ps-test\scripts
Tento příkaz vytvoří nový adresář Scripts v adresáři C:\PS-Test.
Název nové položky adresáře Scripts je obsažen v hodnotě parametru Path, místo aby byl uveden v hodnotě parametru Name. jak je uvedeno v syntaxi, je platná obě formy příkazu.
————————– PŘÍKLAD 5 ————————–
PS C:\>new-item -itemtype file -path "c:\ps-test\test.txt", "c:\ps-test\Logs\test.log"
Tento příkaz používá rutinu New-Item k vytvoření souborů ve dvou různých adresářích. protože parametr Path přebírá více řetězců, můžete jej použít k vytvoření více položek.
Povinné parametry
Určuje název nové položky.
Název nové položky můžete zadat v hodnotě parametru Name nebo Path a cestu k nové položce můžete zadat v hodnotě parametru Name nebo Path.
Typ: | Řetězec |
Pozice: | Pojmenovaná |
Výchozí hodnota: | Žádná |
Přijímá vstup do potrubí: | True (ByPropertyName) |
Akceptovat zástupné znaky: | False |
Určuje cestu k umístění nové položky.
Název nové položky můžete zadat v parametru Name nebo jej zahrnout do parametru Path.
Typ: | Řetězec |
Pozice: | 1 |
Výchozí hodnota: | Žádná |
Přijímá vstup do potrubí: | True (ByPropertyName) |
Akceptovat zástupné znaky: | False |
Nepovinné parametry
Vyzve vás k potvrzení před spuštěním rutiny. vyzve vás k potvrzení před spuštěním rutiny.
Typ: | SwitchParameter |
Aliasy: | cf |
Pozice: | Pojmenovaný |
Výchozí hodnota: | False |
Přijímá vstup do potrubí: | False |
Akceptovat zástupné znaky: | False |
Určuje uživatelský účet, který má oprávnění k provedení této akce.
Zadejte uživatelské jméno, například „User01“ nebo „Domain01\User01“, nebo zadejte objekt PSCredential, například vygenerovaný rutinou Get-Credential. pokud zadáte uživatelské jméno, budete vyzváni k zadání hesla.
Tento parametr není podporován žádným zprostředkovatelem nainstalovaným s prostředím Windows PowerShell
Typ: | PSCredential | |||||||||||||||||||||||||||||||||||||||||||
Pozice: | Pojmenovaný | |||||||||||||||||||||||||||||||||||||||||||
Výchozí hodnota: | Žádná | |||||||||||||||||||||||||||||||||||||||||||
Přijímá vstup do potrubí: | True (ByPropertyName) | |||||||||||||||||||||||||||||||||||||||||||
Akceptovat zástupné znaky:
-UseTransaction
Zahrne příkaz do aktivní transakce. tento parametr je platný pouze v případě probíhající transakce. více informací viz Zahrne příkaz do aktivní transakce. tento parametr je platný pouze v případě probíhající transakce. více informací viz
-Value
Určuje hodnotu nové položky.
-WhatIf
Zobrazí, co se stane, pokud se rutina spustí.
VstupySystem.Object Do rutiny New-Item můžete zadat hodnotu nové položky. VýstupySystem.Object New-Item vrátí vytvořenou položku. PoznámkyRutina New-Item je navržena tak, aby mohla pracovat s daty vystavenými libovolným poskytovatelem. chcete-li zobrazit seznam poskytovatelů dostupných v relaci, zadejte příkaz „Get-PsProvider“. další informace naleznete v části about_Providers.
. |