13. Polecenia cmdlet

Polecenie cmdlet to polecenie z jedną funkcją, które manipuluje obiektami w programie PowerShell. Polecenia cmdlet można rozpoznać za pomocą formatu nazwy, czasownika i rzeczownika oddzielonego kreską (-), Get-Helpna przykład , Get-Processi Start-Service. Wzorzec czasownika jest czasownikiem wyrażonym przy użyciu symboli wieloznacznych, jak w .W* Wzorzec rzeczownika jest rzeczownikiem wyrażonym przy użyciu symboli wieloznacznych, jak w przypadku.

Polecenia cmdlet powinny być proste i powinny być zaprojektowane do pracy w połączeniu z innymi poleceniami cmdlet. Na przykład polecenia cmdlet Get powinny pobierać tylko dane, Polecenia cmdlet Set powinny tylko ustanawiać lub zmieniać dane, Polecenia cmdlet formatu powinny formatować tylko dane, a polecenia cmdlet Out powinny kierować dane wyjściowe tylko do określonego miejsca docelowego.

Dla każdego polecenia cmdlet podaj plik pomocy, do którego można uzyskać dostęp, wpisując:

get-help *cmdlet-name* -detailed

Szczegółowy widok pliku pomocy polecenia cmdlet powinien zawierać opis polecenia cmdlet, składnię polecenia, opisy parametrów i przykład, które pokazują użycie tego polecenia cmdlet.

Polecenia cmdlet są używane podobnie do poleceń i narzędzi systemu operacyjnego. W poleceniach programu PowerShell nie jest wielkość liter.

Uwaga

Uwaga edytora: Oryginalny dokument zawiera listę polecenia cmdlet z opisami, diagramami składni, definicjami parametrów i przykładami. Te informacje są niekompletne i są aktualne. Aby uzyskać bieżące informacje na temat polecenia cmdlet, zapoznaj się z sekcją Dokumentacja w dokumentacji programu PowerShell.

13.1 Typowe parametry

Typowe parametry to zestaw parametrów polecenia cmdlet, których można używać z dowolnym poleceniem cmdlet. Są one implementowane przez samo środowisko uruchomieniowe programu PowerShell, a nie przez dewelopera poleceń cmdlet i są automatycznie dostępne dla dowolnego polecenia cmdlet lub funkcji korzystającej z atrybutu Parameter (}12.3.7) lub atrybutu CmdletBinding (";12.3.5).

Mimo że typowe parametry są akceptowane przez dowolne polecenie cmdlet, mogą nie mieć żadnej semantyki dla tego polecenia cmdlet. Jeśli na przykład polecenie cmdlet nie generuje żadnych pełnych danych wyjściowych, użycie pospolitego parametru Verbose nie ma żadnego efektu.

Kilka typowych parametrów przesłania ustawienia domyślne systemu lub preferencje, które można ustawić za pomocą zmiennych preferencji (";2.3.2.3). W przeciwieństwie do zmiennych preferencji wspólne parametry wpływają tylko na polecenia, w których są używane.

Uwaga

Uwaga edytora: oryginalny dokument zawiera listę wspólnych parametrów. Te informacje są niekompletne i są aktualne. Aby uzyskać bieżące informacje, zobacz about_CommonParameters.