Odnajdywanie parametrów dotyczących używania poleceń cmdlet programu PowerShell

Ukończone

Parametry modyfikują akcje wykonywane przez polecenie cmdlet. Dla polecenia cmdlet nie można określić żadnych parametrów, jednego parametru ani wielu parametrów.

Format parametru

Nazwy parametrów zaczynają się od kreski (-). Spacja oddziela wartość, którą chcesz przekazać z nazwy parametru. Jeśli przekazywana wartość zawiera spacje, musisz opakowować tekst w cudzysłowie. Niektóre parametry akceptują wiele wartości, które należy oddzielić przecinkami i bez spacji.

Opcjonalne a wymagane parametry

Parametry mogą być opcjonalne lub wymagane. Jeśli parametr jest wymagany i uruchamiasz polecenie cmdlet bez podawania wartości dla tego parametru, program Windows PowerShell wyświetli monit o podanie wartości. Jeśli na przykład uruchomisz polecenie Get-Item, zostanie wyświetlony następujący komunikat z programu Windows PowerShell, który zawiera monit o podanie wartości parametru -Path :

PS C:\> Get-Item cmdlet Get-Item at command pipeline position 1 Supply values for the following parameters: Path[0]:

Jeśli wprowadzisz tekst C:\ w wierszu polecenia, a następnie naciśnij dwukrotnie Enter, polecenie zostanie pomyślnie uruchomione. Musisz dwukrotnie nacisnąć Enter, ponieważ ten parametr może akceptować wiele wartości. Program Windows PowerShell kontynuuje monitowanie o nową wartość do momentu naciśnięcia Enter bez podawania go.

W niektórych przypadkach wprowadzenie nazwy parametru jest opcjonalne i można po prostu wprowadzić wartość parametru. Jeśli uruchomisz polecenie Get-ChildItem C:\, jest to samo, co uruchomienie polecenia Get-ChildItem -Path C:\ , ponieważ parametr -Path jest zdefiniowany jako pierwszy parametr w definicji polecenia cmdlet. Jest to nazywane parametrem pozycyjnym. Zauważysz je w trakcie tego kursu. Pominięcie nazwy parametru działa tylko wtedy, gdy zdefiniowano położenie parametru. Nie wszystkie polecenia mają parametry pozycyjne.

Switches (Układy samoczynnego załączania)

Przełączniki są specjalnym przypadkiem. Są to zasadniczo parametry, które akceptują wartość logiczną (prawda lub fałsz). Różnią się one od rzeczywistych parametrów logicznych w tym, że wartość jest ustawiona tylko na wartość true , jeśli przełącznik jest uwzględniony podczas uruchamiania polecenia. Przykładem jest parametr -Recurse lub przełącznik polecenia cmdlet Get-ChildItem . Polecenie Get-ChildItem c:\ -Recurse zwraca nie tylko elementy w katalogu C:\, ale także te we wszystkich jego podkatalogach. Bez przełącznika -Recurse zwracane są tylko elementy w katalogu C:\.