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-Help
na przykład , Get-Process
i 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.
Opinia
https://aka.ms/ContentUserFeedback.
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź:Prześlij i wyświetl opinię dla