New-Item – tworzenie nowego pliku/folderu

New-Item w PowerShell tworzy nowy plik lub folder — np. New-Item -Path C:\Test -ItemType Directory tworzy nowy katalog.

New-Item w PowerShell: polecenie do tworzenia elementów systemu plików

New-Item jest poleceniem cmdlet środowiska PowerShell służącym do tworzenia nowych elementów. W typowym zastosowaniu elementem jest plik albo folder, nazywany również katalogiem. Polecenie może działać w bieżącej lokalizacji powłoki lub otrzymać pełną ścieżkę wskazaną parametrem -Path. Przykładowo, New-Item -Path 'C:\Test\Raport.txt' -ItemType File tworzy plik tekstowy Raport.txt w katalogu C:\Test, jeżeli wskazana lokalizacja nadrzędna już istnieje.

Rodzaj tworzonego elementu określa parametr -ItemType. W przypadku katalogu stosuje się wartość Directory, a w przypadku zwykłego pliku wartość File. Przykład New-Item -Path 'C:\Test\Archiwum' -ItemType Directory tworzy nowy katalog. Parametr -Name może służyć do podania nazwy elementu względem określonej ścieżki, natomiast -Value pozwala przekazać zawartość podczas tworzenia niektórych typów elementów, w tym pliku.

Ścieżka, typ elementu i zawartość nowego pliku

PowerShell interpretuje ścieżkę zgodnie z używanym dostawcą systemu, czyli mechanizmem udostępniającym określony typ danych jako strukturę przypominającą system plików. Przy pracy z lokalnymi plikami najczęściej używany jest dostawca FileSystem, dlatego ścieżki takie jak C:\Dane\plik.txt albo .\plik.txt odnoszą się do dysku i katalogów. Kropka oznacza bieżącą lokalizację, a zapis ..\ wskazuje katalog nadrzędny. Przed wykonaniem polecenia można sprawdzić bieżącą lokalizację za pomocą Get-Location.

Nowy plik można utworzyć bez treści albo od razu wprowadzić do niego tekst. Przykładowo, New-Item -Path '.\notatka.txt' -ItemType File -Value 'Pierwsza linia' tworzy plik z podaną zawartością. Do dopisywania kolejnych danych służy później między innymi Add-Content, a do zastępowania zawartości można użyć Set-Content. Samo New-Item nie jest przeznaczone do edycji istniejącego pliku. Jeżeli wskazany plik już istnieje, próba utworzenia elementu o tej samej nazwie może zakończyć się błędem, zależnie od użytych parametrów i właściwości elementu.

Kontrola skutków działania New-Item

Przed utworzeniem pliku lub folderu warto sprawdzić, czy lokalizacja nadrzędna istnieje oraz czy bieżące konto ma prawo zapisu. Do weryfikacji obecności elementu służy między innymi Test-Path, na przykład Test-Path 'C:\Test'. Wynik True oznacza, że wskazana ścieżka została odnaleziona, natomiast False wskazuje na jej brak. Brak katalogu nadrzędnego często powoduje niepowodzenie tworzenia pliku, ponieważ New-Item nie powinno być traktowane jako automatyczne narzędzie do budowania całej, nieistniejącej struktury ścieżki bez sprawdzenia kolejnych poziomów.

Po wykonaniu polecenia PowerShell zwykle zwraca obiekt opisujący utworzony element. Można go przekazać potokiem do innych cmdletów albo ponownie odczytać zawartość katalogu poleceniem Get-ChildItem. Warto zwrócić uwagę na komunikaty dotyczące odmowy dostępu, nieprawidłowej nazwy, niedostępnego dysku lub zajętej lokalizacji. Problemy mogą wynikać także z użycia ścieżki sieciowej, braku połączenia z zasobem albo z ograniczeń narzuconych przez uprawnienia systemu Windows. Przy automatyzacji dobrze jest obsłużyć błędy i nie zakładać, że utworzenie elementu zawsze zakończy się powodzeniem.

New-Item podczas pracy serwisowej z systemem Windows

New-Item jest przydatne w skryptach PowerShell, które przygotowują katalog roboczy, tworzą plik konfiguracyjny albo sprawdzają zachowanie systemu plików. Należy jednak zachować ostrożność przy ścieżkach systemowych, ponieważ utworzenie elementu w niewłaściwym miejscu może zmienić działanie programu lub doprowadzić do konfliktu nazw. Przed użyciem polecenia warto zweryfikować ścieżkę, typ elementu, wymagane uprawnienia oraz to, czy operacja ma utworzyć nowy plik, czy tylko zmodyfikować już istniejący.

Warszawskie Pogotowie Komputerowe wykonuje profesjonalną naprawę laptopów, komputerów PC i ich podzespołów, w tym diagnostykę problemów z systemem Windows, działaniem skryptów PowerShell oraz dostępem do plików i katalogów. W przypadku błędów polecenia New-Item analizowane są między innymi komunikat PowerShell, poprawność ścieżki, istnienie katalogu nadrzędnego, uprawnienia konta i stan nośnika danych. Takie rozdzielenie przyczyny od samego komunikatu pozwala ustalić, czy problem dotyczy składni polecenia, konfiguracji systemu, konta użytkownika, systemu plików czy fizycznego działania dysku.