Składnia
mkdir <String>
mkdir <String>] -Name <String>
Opis
cmdlet New-Item tworzy nowy element i ustawia jego wartość.Typy elementów, które można utworzyć, zależą od lokalizacji elementu.Na przykład w systemie plików New-Item służy do tworzenia plików i folderów.W rejestrze New-Item tworzy klucze i wpisy rejestru.
New-Item może również ustawiać wartość elementów, które tworzy.Na przykład, podczas tworzenia nowego pliku, New-Item może dodać początkową zawartość do pliku.
Przykłady
————————– PRZYKŁAD 1 ————————–
PS C:\>new-item -path . -name testfile1.txt -itemtype "file" -value "This is a text string."
To polecenie tworzy plik tekstowy o nazwie testfile1.txt w bieżącym katalogu.Kropka (.) w wartości parametru Path wskazuje bieżący katalog.Tekst w cudzysłowie, który następuje po parametrze Value, jest dodawany do pliku jako zawartość.
————————– PRZYKŁAD 2 ————————–
PS C:\>new-item -path c:\ -name logfiles -itemtype directory
To polecenie tworzy katalog o nazwie Logfiles w napędzie C:.Parametr ItemType określa, że nowy element jest katalogiem, a nie plikiem lub innym obiektem systemu plików.
————————– PRZYKŁAD 3 ————————–
PS C:\>new-item -path $profile -itemtype file -force
To polecenie tworzy profil Windows PowerShell w ścieżce, która jest określona przez zmienną $profile.
Możesz używać profili do dostosowywania Windows PowerShell.$profile jest zmienną automatyczną (wbudowaną), która przechowuje ścieżkę i nazwę pliku profilu CurrentUser/CurrentHost.Domyślnie profil nie istnieje, mimo że Windows PowerShell przechowuje dla niego ścieżkę i nazwę pliku.
W tym poleceniu zmienna $profile reprezentuje ścieżkę do pliku.Parametr ItemType określa, że polecenie tworzy plik.Parametr Force pozwala utworzyć plik w ścieżce profilu, nawet gdy katalogi w ścieżce nie istnieją (Windows PowerShell je tworzy).
Po użyciu tego polecenia do utworzenia profilu, można w nim wprowadzić aliasy, funkcje i skrypty w celu dostosowania powłoki.
Więcej informacji można znaleźć w about_Automatic_Variables i about_Profiles.
————————– PRZYKŁAD 4 ————————–
PS C:\>new-item -itemtype directory -path c:\ps-test\scripts
To polecenie tworzy nowy katalog Scripts w katalogu C:\PS-Test.
Nazwa nowej pozycji katalogu, Scripts, jest zawarta w wartości parametru Path, zamiast być określona w wartości parametru Name.Jak wskazuje składnia, każda z form polecenia jest poprawna.
————————– PRZYKŁAD 5 ————————–
PS C:\>new-item -itemtype file -path "c:\ps-test\test.txt", "c:\ps-test\Logs\test.log"
To polecenie używa polecenia cmdlet New-Item do utworzenia plików w dwóch różnych katalogach.Ponieważ parametr Path przyjmuje wiele ciągów znaków, można go użyć do utworzenia wielu elementów.
Wymagane parametry
Określa nazwę nowego elementu.
Nazwę nowego elementu można określić w wartości parametru Nazwa lub Ścieżka, a ścieżkę do nowego elementu można określić w wartości parametru Nazwa lub Ścieżka.
Typ: | String |
Pozycja: | Nazwane |
Wartość domyślna: | Brak |
Akceptuje dane wejściowe rurociągu: | True (ByPropertyName) |
Akceptuj znaki wieloznaczne: | False |
Określa ścieżkę do lokalizacji nowego elementu.Dozwolone są znaki wieloznaczne.
Nazwę nowego elementu można określić w parametrze Nazwa lub zawrzeć ją w parametrze Ścieżka.
Typ: | String |
Position: | 1 |
Wartość domyślna: | Brak |
Akceptuje dane wejściowe rurociągu: | True (ByPropertyName) |
Akceptuj znaki wieloznaczne: | False |
Optional Parameters
Prompts for confirmation before running the cmdlet.Prompts for confirmation before running the cmdlet.
Typ: | SwitchParameter |
Aliasy: | cf |
Position: | Named |
Wartość domyślna: | False |
Akceptuje dane wejściowe rurociągu: | False |
Akceptuj znaki wieloznaczne: | False |
Określa konto użytkownika, które ma uprawnienia do wykonywania tej czynności.Domyślnie jest to użytkownik bieżący.
Wpisz nazwę użytkownika, taką jak „User01” lub „Domain01User01”, lub wprowadź obiekt PSCredential, taki jak wygenerowany przez cmdlet Get-Credential.Jeśli wpiszesz nazwę użytkownika, zostaniesz poproszony o podanie hasła.
Ten parametr nie jest obsługiwany przez żadnych dostawców zainstalowanych z Windows PowerShell
Typ: | PSCredential |
Position: | Named |
Wartość domyślna: | Brak |
Akceptuje dane wejściowe rurociągu: | True (ByPropertyName) |
Akceptuj znaki wieloznaczne: | False |
Umożliwia cmdletowi utworzenie elementu, który zapisuje nad istniejącym elementem tylko do odczytu.Implementacja różni się w zależności od dostawcy.Aby uzyskać więcej informacji, zobacz about_Providers.Nawet używając parametru Force, cmdlet nie może nadpisać ograniczeń zabezpieczeń.
Typ: | SwitchParameter |
Position: | Named |
Wartość domyślna: | Brak |
Akceptuje dane wejściowe rurociągu: | False |
Akceptuj znaki wieloznaczne: | False |
Włącza polecenie do aktywnej transakcji.Ten parametr jest ważny tylko wtedy, gdy transakcja jest w toku.Aby uzyskać więcej informacji, zobacz Włącza polecenie do aktywnej transakcji.Ten parametr jest ważny tylko wtedy, gdy transakcja jest w toku.Aby uzyskać więcej informacji, zobacz
Typ: | SwitchParameter |
Aliasy: | usetx |
Pozycja: | Nazwany |
Wartość domyślna: | False |
Akceptuje dane wejściowe rurociągu: | False |
Akceptuj znaki wieloznaczne: | False |
Określa wartość nowego elementu.Do New-Item można również potokować wartość.
Typ: | Obiekt |
Pozycja: | Named |
Wartość domyślna: | Brak |
Akceptuje dane wejściowe rurociągu: | True (ByPropertyName, ByValue) |
Akceptuj znaki wieloznaczne: | False |
Pokazuje, co by się stało, gdyby cmdlet został uruchomiony.cmdlet nie jest uruchamiany.
Typ: | SwitchParameter |
Aliasy: | wi |
Pozycja: | Named |
Default value: | False |
Akceptuje dane wejściowe rurociągu: | False |
Akceptuj znaki wieloznaczne: | False |
Wejścia
System.Object
Do cmdleta New-Item można przekazać potokiem wartość dla nowego elementu.
Wyjścia
System.Object
New-Item zwraca element, który tworzy.
Uwagi
cmdlet New-Item został zaprojektowany do pracy z danymi udostępnianymi przez dowolnego dostawcę.Aby wyświetlić listę dostawców dostępnych w sesji, wpisz „Get-PsProvider”.Aby uzyskać więcej informacji, zobacz about_Providers.
- Clear-Item
- Copy-Item
- Get-Item
- Invoke-Item
- Move-Item
- Remove-Item
- Rename-Item
- Set-Item
- about_Providers
.