mkdir

Moduł: Microsoft.PowerShell.Core
Tworzy nowy element.

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

-Name

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

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

-Confirm

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

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

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

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

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

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

.

Dodaj komentarz

Twój adres e-mail nie zostanie opublikowany.