13. Cmdlety

Notatka redakcyjna

Ważny

Specyfikacja języka Windows PowerShell 3.0 została opublikowana w grudniu 2012 r. i jest oparta na Windows PowerShell 3.0. Ta specyfikacja nie odzwierciedla bieżącego stanu programu PowerShell. Nie ma planu aktualizacji tej dokumentacji w celu odzwierciedlenia bieżącego stanu. Ta dokumentacja jest przedstawiona tutaj w celu uzyskania informacji historycznych.

Dokument specyfikacji jest dostępny jako dokument programu Microsoft Word z Centrum pobierania Microsoft pod adresem: https://www.microsoft.com/download/details.aspx?id=36389 Dokument programu Word został przekonwertowany na prezentację tutaj w witrynie Microsoft Learn. Podczas konwersji wprowadzono pewne zmiany redakcyjne w celu dostosowania formatowania dla platformy Docs. Usunięto niektóre literówki i drobne błędy.

Polecenie cmdlet to polecenie z jedną funkcją, które manipuluje obiektami w programie PowerShell. Polecenia cmdlet mogą być rozpoznawane po formacie nazwy, czasownik i rzeczownik oddzielone kreską (-), takimi jak Get-Help, Get-Processi Start-Service. Wzorzec czasownika to czasownik wyrażony za pomocą symboli wieloznacznych, jak w W*. Rzeczownikowy wzorzec jest rzeczownikiem wyrażonym przy użyciu symboli wieloznacznych, jak na przykład wydarzenie.

Polecenia cmdlet powinny być proste i zaprojektowane tak, aby były używane w połączeniu z innymi poleceniami cmdlet. Na przykład polecenia cmdlet Get powinny pobierać tylko dane, polecenia cmdlet Set powinny ustanowić lub zmienić dane, polecenia cmdlet Format 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óry demonstruje użycie tego polecenia cmdlet.

Polecenia cmdlet są używane podobnie do poleceń i narzędzi systemu operacyjnego. Polecenia programu PowerShell nie są czułe na wielkość liter.

Notatka

Uwaga edytora: oryginalny dokument zawiera listę cmdletów z opisami, diagramami składni, definicjami parametrów i przykładami. Te informacje są niekompletne i nieaktualne. Aby uzyskać bieżące informacje o poleceniach cmdlet, zapoznaj się z sekcją Reference w dokumentacji PowerShell.

13.1 Typowe parametry

Typowe parametry to zestaw parametrów cmdletów, które można stosować z dowolnym cmdletem. Są one implementowane przez samo środowisko uruchomieniowe programu PowerShell, a nie przez dewelopera poleceń cmdlet i są one automatycznie dostępne dla dowolnego polecenia cmdlet lub funkcji używającej atrybutu Parametr (§12.3.7) lub cmdletBinding atrybut (§12.3.5).

Chociaż typowe parametry są akceptowane przez dowolne polecenie cmdlet, mogą nie mieć żadnej semantyki. Jeśli na przykład polecenie cmdlet nie generuje żadnych szczegółowych danych wyjściowych, użycie Verbose parametru ogólnego nie ma wpływu.

Kilka typowych parametrów zastępuje domyślne lub preferencje systemowe, które można ustawić za pomocą zmiennych preferencji (§2.3.2.3). W przeciwieństwie do zmiennych preferencji wspólne parametry mają wpływ tylko na polecenia, w których są używane.

Notatka

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