Zatwierdzone czasowniki dla poleceń programu PowerShell

  • Artykuł

Program PowerShell używa pary czasownik-rzeczownik dla nazw poleceń cmdlet i ich pochodnych klas .NET. Część czasownika nazwy identyfikuje akcję, która wykonuje polecenie cmdlet. Część nazwy w rzeczowniku identyfikuje jednostkę, na której jest wykonywana akcja. Na przykład polecenie Get-Command cmdlet pobiera wszystkie polecenia, które są zarejestrowane w programie PowerShell.

Uwaga

Program PowerShell używa terminu czasownik do opisania słowa, które implikuje akcję, nawet jeśli to słowo nie jest standardowym czasownikiem w języku angielskim. Na przykład termin New (Nowy ) jest prawidłową nazwą czasownika programu PowerShell, ponieważ implikuje akcję, mimo że nie jest to czasownik w języku angielskim.

Każdy zatwierdzony czasownik ma zdefiniowany odpowiedni prefiks aliasu . Tego prefiksu aliasu używamy w aliasach dla poleceń używających tego czasownika. Na przykład prefiks aliasu dla elementu Import to ip , a w związku z tym alias dla elementu Import-Module to ipmo. Jest to zalecenie, ale nie reguła. W szczególności nie musi być przestrzegana w przypadku aliasów poleceń imitujących dobrze znane polecenia z innych środowisk.

Nazwa czasownika Rekomendacje

Poniższe zalecenia ułatwiają wybranie odpowiedniego czasownika dla polecenia cmdlet w celu zapewnienia spójności między poleceniami cmdlet, które tworzysz, poleceniami cmdlet dostarczanymi przez program PowerShell i poleceniami cmdlet zaprojektowanymi przez inne osoby.

  • Użyj jednej ze wstępnie zdefiniowanych nazw czasowników dostarczonych przez program PowerShell
  • Użyj czasownika , aby opisać ogólny zakres akcji, a następnie za pomocą parametrów uściślij akcję polecenia cmdlet.
  • Nie używaj synonimu zatwierdzonego zlecenia. Na przykład zawsze używaj , nigdy nie Removeużywaj ani Eliminate``Delete .
  • Należy używać tylko formy każdego zlecenia wymienionego w tym temacie. Na przykład użyj , Getale nie używaj ani Getting Gets.
  • Nie używaj następujących zarezerwowanych czasowników ani aliasów. Język programu PowerShell i kilka rzadkich poleceń cmdlet używa tych czasowników w wyjątkowej sytuacji.
    • ForEach (foreach)
    • Ping (pi)
    • Sort (sr)
    • Tee (te)
    • Where (wh)

Pełna lista zleceń może zostać wyświetlona przy użyciu polecenia Get-Verb cmdlet .

Podobne czasowniki dla różnych akcji

Następujące podobne czasowniki reprezentują różne akcje.

Nowe a Dodaj

Użyj czasownika New , aby utworzyć nowy zasób. Użyj , Add aby dodać coś do istniejącego kontenera lub zasobu. Na przykład element Add-Content dodaje dane wyjściowe do istniejącego pliku.

Nowe a zestaw

Użyj czasownika New , aby utworzyć nowy zasób. Użyj czasownika Set , aby zmodyfikować istniejący zasób, opcjonalnie tworząc go, jeśli nie istnieje, na przykład Set-Variable polecenia cmdlet .

Użyj czasownika Find , aby poszukać obiektu. Użyj czasownika Search , aby utworzyć odwołanie do zasobu w kontenerze.

Pobierz a Odczytaj

Czasownik Get umożliwia uzyskanie informacji o zasobie (takim jak plik) lub uzyskanie obiektu, za pomocą którego można uzyskać dostęp do zasobu w przyszłości. Użyj czasownika Read , aby otworzyć zasób i wyodrębnić zawarte w nim informacje.

Wywoływanie a uruchamianie

Użyj czasownika Invoke , aby wykonać operacje synchroniczne, takie jak uruchomienie polecenia i oczekiwanie na jego zakończenie. Użyj czasownika Start , aby rozpocząć operacje asynchroniczne, takie jak uruchamianie procesu autonomicznego.

Ping a Test

Użyj czasownika Test .

Typowe czasowniki

Program PowerShell używa klasy wyliczenia System.Management.Automation.VerbsCommon do definiowania ogólnych akcji, które mogą być stosowane do niemal każdego polecenia cmdlet. W poniższej tabeli wymieniono większość zdefiniowanych zleceń.

Czasownik (alias) Akcja Synonimy, których należy unikać
Dodaj (a) Dodaje zasób do kontenera lub dołącza element do innego elementu. Na przykład polecenie Add-Content cmdlet dodaje zawartość do pliku. To zlecenie jest sparowane z .Remove Dołączanie, dołączanie, dołączanie, wstawianie
Clear (cl) Usuwa wszystkie zasoby z kontenera, ale nie usuwa kontenera. Na przykład polecenie Clear-Content cmdlet usuwa zawartość pliku, ale nie usuwa pliku. Flush, Erase, Release, Unmark, Unset, Nullify
Zamknij (cs) Zmienia stan zasobu, aby był niedostępny, niedostępny lub bezużytelny. To zlecenie jest sparowane z Open.
Kopiuj (cp) Kopiuje zasób do innej nazwy lub do innego kontenera. Na przykład polecenie Copy-Item cmdlet kopiuje element (na przykład plik) z jednej lokalizacji w magazynie danych do innej lokalizacji. Duplikuj, Klonuj, Replikuj, Synchronizuj
Wprowadź (et) Określa akcję, która umożliwia użytkownikowi przejście do zasobu. Na przykład polecenie Enter-PSSession cmdlet umieszcza użytkownika w sesji interakcyjnej. To zlecenie jest sparowane z .Exit Wypychanie, do
Wyjdź (np.) Ustawia bieżące środowisko lub kontekst do ostatnio używanego kontekstu. Na przykład polecenie Exit-PSSession cmdlet umieszcza użytkownika w sesji, która została użyta do uruchomienia sesji interakcyjnej. To zlecenie jest sparowane z .Enter Pop, Out
Znajdź (fd) Wyszukuje obiekt w kontenerze, który jest nieznany, dorozumiany, opcjonalny lub określony. Wyszukaj
Format (f) Rozmieszcza obiekty w określonym formularzu lub układzie
Pobierz (g) Określa akcję, która pobiera zasób. To zlecenie jest sparowane z .Set Read, Open, Cat, Type, Dir, Obtain, Dump, Acquire, Examine, Find, Search
Ukryj (h) Sprawia, że zasób jest niewykrywalny. Na przykład polecenie cmdlet, którego nazwa zawiera czasownik Ukryj, może spowodować, że usługa będzie pochodzić od użytkownika. To zlecenie jest sparowane z .Show Zablokowanie
Sprzężenia (j) Łączy zasoby w jeden zasób. Na przykład polecenie Join-Path cmdlet łączy ścieżkę z jedną ze ścieżek podrzędnych w celu utworzenia pojedynczej ścieżki. To zlecenie jest sparowane z .Split Łączenie, unite, Połączenie, kojarzenie
Blokada (lk) Zabezpiecza zasób. To zlecenie jest sparowane z .Unlock Ograniczanie, zabezpieczanie
Przenoszenie (m) Przenosi zasób z jednej lokalizacji do innej. Na przykład polecenie Move-Item cmdlet przenosi element z jednej lokalizacji w magazynie danych do innej lokalizacji. Przenoszenie, nazwa, migracja
Nowe (n) Tworzy zasób. (Czasownik Set może być również używany podczas tworzenia zasobu, który zawiera dane, takie jak Set-Variable polecenie cmdlet). Tworzenie, generowanie, kompilowanie, tworzenie, przydzielanie
Otwórz (op) Zmienia stan zasobu, aby był dostępny, dostępny lub użyteczny. To zlecenie jest sparowane z .Close
Optymalizacja (om) Zwiększa efektywność zasobu.
Pop (pop) Usuwa element z góry stosu. Na przykład polecenie Pop-Location cmdlet zmienia bieżącą lokalizację na lokalizację, która została ostatnio wypchnięła do stosu.
Wypychanie (pu) Dodaje element na początku stosu. Na przykład polecenie Push-Location cmdlet wypycha bieżącą lokalizację do stosu.
Ponowne ( re) Resetuje zasób do stanu, który został cofnięty.
Usuń (r) Usuwa zasób z kontenera. Na przykład polecenie Remove-Variable cmdlet usuwa zmienną i jej wartość. To zlecenie jest sparowane z .Add Clear, Cut, Dispose, Discard, Erase
Zmień nazwę (rn) Zmienia nazwę zasobu. Na przykład polecenie Rename-Item cmdlet , które służy do uzyskiwania dostępu do przechowywanych danych, zmienia nazwę elementu w magazynie danych. Zmiana
Resetowanie (rs) Ustawia zasób z powrotem do pierwotnego stanu.
Resize(rz) Zmienia rozmiar zasobu.
Wyszukiwanie (sr) Tworzy odwołanie do zasobu w kontenerze. Znajdowanie, lokalizowanie
Wybierz pozycję (sc) Lokalizuje zasób w kontenerze. Na przykład polecenie Select-String cmdlet znajduje tekst w ciągach i plikach. Znajdowanie, lokalizowanie
Zestaw (s) Zastępuje dane w istniejącym zasobie lub tworzy zasób, który zawiera pewne dane. Na przykład polecenie Set-Date cmdlet zmienia czas systemowy na komputerze lokalnym. (Czasownik New może również służyć do tworzenia zasobu). To zlecenie jest sparowane z .Get Zapis, resetowanie, przypisywanie, konfigurowanie
Pokaż (sh) Sprawia, że zasób jest widoczny dla użytkownika. To zlecenie jest sparowane z .Hide Wyświetlanie, tworzenie
Pomiń (sk) Pomija jeden lub więcej zasobów lub punktów w sekwencji. Obejście, skok
Podział (sl) Oddziela części zasobu. Na przykład polecenie Split-Path cmdlet zwraca różne części ścieżki. To zlecenie jest sparowane z .Join Oddzielne
Krok (st) Przechodzi do następnego punktu lub zasobu w sekwencji.
Przełącznik (sw) Określa akcję, która przełącza się między dwoma zasobami, na przykład w celu zmiany między dwiema lokalizacjami, obowiązkami lub stanami.
Cofanie (cofnięcie) Ustawia zasób na jego poprzedni stan.
Unlock (Zjednoczone Królestwo) Zwalnia zablokowany zasób. To zlecenie jest sparowane z .Lock Release, Unrestrict, Unsecure
Obejrzyj (wc) Stale sprawdza lub monitoruje zasób pod aby uzyskać zmiany.

Czasowniki komunikacyjne

Program PowerShell używa klasy System.Management.Automation.VerbsCommunications do definiowania akcji, które mają zastosowanie do komunikacji. W poniższej tabeli wymieniono większość zdefiniowanych zleceń.

Czasownik (alias) Akcja Synonimy, których należy unikać
Połączenie (cc) Tworzy połączenie między miejscem źródłowym i docelowym. To zlecenie jest sparowane z .Disconnect Join, Telnet
Rozłącz (dc) Przerywa połączenie między źródłem i miejscem docelowym. To zlecenie jest sparowane z .Connect Przerwij, Wyloguj
Odczyt (rd) Uzyskuje informacje ze źródła. To zlecenie jest sparowane z .Write Uzyskiwanie, monit, uzyskiwanie
Odbieranie (rc) Akceptuje informacje wysyłane ze źródła. To zlecenie jest sparowane z .Send Odczyt, Akceptowanie, Podgląd
Wyślij (sd) Dostarcza informacje do miejsca docelowego. To zlecenie jest sparowane z .Receive Put, Broadcast, Mail, Faks
Zapis (wr) Dodaje informacje do obiektu docelowego. To zlecenie jest sparowane z .Read Put, Print

Czasowniki danych

Program PowerShell używa klasy System.Management.Automation.VerbsData do definiowania akcji, które mają zastosowanie do obsługi danych. W poniższej tabeli wymieniono większość zdefiniowanych zleceń.

Nazwa zlecenia (alias) Akcja Synonimy, których należy unikać
Kopia zapasowa (ba) Przechowuje dane przez ich replikowanie. Zapisywanie, nagrywanie, replikowanie, synchronizacja
Punkt kontrolny (ch) Tworzy migawkę bieżącego stanu danych lub ich konfiguracji. Diff
Porównanie (cr) Ocenia dane z jednego zasobu względem danych z innego zasobu. Diff
Kompresowanie (cm) Kompaktuje dane zasobu. Paruje z .Expand CD
Konwertowanie (cv) Zmienia dane z jednej reprezentacji na inną, gdy polecenie cmdlet obsługuje konwersję dwukierunkową lub gdy polecenie cmdlet obsługuje konwersję między wieloma typami danych. Zmienianie, zmienianie rozmiaru, próbkowanie
ConvertFrom (cf) Konwertuje jeden podstawowy typ danych wejściowych (rzeczownik polecenia cmdlet wskazuje dane wejściowe) na co najmniej jeden obsługiwany typ danych wyjściowych. Eksportowanie, wyjście, wyjście
ConvertTo (ct) Konwertuje z co najmniej jednego typu danych wejściowych na podstawowy typ danych wyjściowych (rzeczownik polecenia cmdlet wskazuje typ danych wyjściowych). Import, Dane wejściowe, In
Odinstaluj (dm) Odłącza nazwaną jednostkę od lokalizacji. To zlecenie jest sparowane z .Mount Odinstaluj, Odwiąz odłączyć
Edytuj (red.) Modyfikuje istniejące dane przez dodanie lub usunięcie zawartości. Zmienianie, aktualizowanie, modyfikowanie
Rozwiń (en) Przywraca dane zasobu, który został skompresowany do pierwotnego stanu. To zlecenie jest sparowane z .Compress Wzręb, dekompresja
Eksportowanie (ep) Hermetyzuje podstawowe dane wejściowe do trwałego magazynu danych, takiego jak plik, lub do formatu wymiany. To zlecenie jest sparowane z .Import Wyodrębnianie, tworzenie kopii zapasowej
Grupa (gp) Organizuje lub kojarzy jeden lub więcej zasobów
Importowanie (ip) Tworzy zasób na pomocą danych przechowywanych w trwałym magazynie danych (takim jak plik) lub w formacie wymiany. Na przykład polecenie cmdlet importuje dane z pliku wartości rozdzielanych przecinkami (CSV) do obiektów, Import-CSV które mogą być używane przez inne polecenia cmdlet. To zlecenie jest sparowane z .Export BulkLoad, Load
Inicjowanie (w) Przygotowuje zasób do użycia i ustawia go na stan domyślny. Erase, Init, Renew, Rebuild, Reinitialize, Setup
Limit (l) Stosuje ograniczenia do zasobu. limit przydziału
Scal (mg) Tworzy pojedynczy zasób z wielu zasobów. Łączenie, łączenie
Mount (mt) Dołącza nazwaną jednostkę do lokalizacji. To zlecenie jest sparowane z .Dismount Połącz
Out (o) Wysyła dane ze środowiska. Na przykład polecenie Out-Printer cmdlet wysyła dane do drukarki.
Publikowanie (pb) Udostępnia zasób innym osobom. To zlecenie jest sparowane z .Unpublish Wdrażanie, wydanie, instalowanie
Przywracanie (rr) Ustawia zasób na wstępnie zdefiniowany stan, taki jak stan ustawiony przez .Checkpoint Na przykład polecenie Restore-Computer cmdlet uruchamia przywracanie systemu na komputerze lokalnym. Naprawianie, zwracanie, cofanie, naprawianie
Zapisz (sv) Zachowuje dane, aby uniknąć utraty.
Synchronizacja (sy) Zapewnia, że co najmniej dwa zasoby są w tym samym stanie. Replikowanie, koercja, dopasowanie
Cofanie publikacji (g) Sprawia, że zasób jest niedostępny dla innych. To zlecenie jest sparowane z .Publish Odinstalowywanie, przywracanie, ukrywanie
Aktualizacja (ud) Zapewnia aktualny zasób w celu zachowania jego stanu, dokładności, zgodności lub zgodności. Na przykład polecenie Update-FormatData cmdlet aktualizuje i dodaje pliki formatowania do bieżącej konsoli programu PowerShell. Odświeżanie, odnawianie, ponowne obliczanie, ponowne indeksowanie

Czasowniki diagnostyczne

Program PowerShell używa klasy System.Management.Automation.VerbsDiagnostic do definiowania akcji, które mają zastosowanie do diagnostyki. W poniższej tabeli wymieniono większość zdefiniowanych zleceń.

Czasownik (alias) Akcja Synonimy, których należy unikać
Debugowanie (db) Analizuje zasób w celu zdiagnozowania problemów operacyjnych. Zdiagnozować
Miara (ms) Identyfikuje zasoby używane przez określoną operację lub pobiera statystyki dotyczące zasobu. Obliczanie, określanie, analizowanie
Ping (pi) Przestarzałe — zamiast tego użyj czasownika Test.
Repair (rp) Przywraca zasób do warunku możliwego do użycia Poprawka, przywracanie
Rozwiązywanie (rv) Mapy skróconą reprezentację zasobu w celu pełniejszej reprezentacji. Rozwijanie, określanie
Test (t) Weryfikuje operację lub spójność zasobu. Diagnozowanie, analizowanie, odzyskane, weryfikowanie
Trace (tr) Śledzi działania zasobu. Śledzenie, obserwowanie, inspekcja, parser

Czasowniki cyklu życia

Program PowerShell używa klasy System.Management.Automation.VerbsLifeCycle do definiowania akcji, które mają zastosowanie do cyklu życia zasobu. W poniższej tabeli wymieniono większość zdefiniowanych zleceń.

Czasownik (alias) Akcja Synonimy, których należy unikać
Zatwierdź (ap) Potwierdza lub akceptuje stan zasobu lub procesu.
Assert (as) Potwierdza stan zasobu. Certify
Kompilacja (bd) Tworzy artefakt (zazwyczaj plik binarny lub dokument) z zestawu plików wejściowych (zazwyczaj kodu źródłowego lub dokumentów deklaratywnych). To zlecenie zostało dodane w programie PowerShell 6.
Ukończono (cp) Kończy operację.
Potwierdź (cn) Potwierdza, weryfikuje lub weryfikuje stan zasobu lub procesu. Potwierdzanie, wyrażanie zgody, certyfikowanie, weryfikowanie, weryfikowanie
Odmów (dn) Odrzuca, obiektuje, blokuje lub blokuje stan zasobu lub procesu. Blokuj, Obiekt, Odrzucaj, Odrzucaj
Wdrażanie (dp) Wysyła aplikację, witrynę internetową lub rozwiązanie do zdalnego obiektu docelowego w taki sposób, aby konsument tego rozwiązania miał do niego dostęp po zakończeniu wdrażania. To zlecenie zostało dodane w programie PowerShell 6.
Wyłącz (d) Konfiguruje zasób w stanie niedostępnym lub nieaktywnym. Na przykład polecenie Disable-PSBreakpoint cmdlet powoduje, że punkt przerwania jest nieaktywny. To zlecenie jest sparowane z .Enable Halt, Hide
Włącz (e) Konfiguruje zasób w stanie dostępnym lub aktywnym. Na przykład polecenie Enable-PSBreakpoint cmdlet powoduje, że punkt przerwania jest aktywny. To zlecenie jest sparowane z .Disable Start, Begin
Instalowanie (to) Umieszcza zasób w lokalizacji i opcjonalnie go inicjuje. To zlecenie jest sparowane z .Uninstall Konfigurowanie
Wywołaj (i) Wykonuje akcję, taką jak uruchomienie polecenia lub metody. Uruchamianie, uruchamianie
Rejestrowanie (rg) Tworzy wpis dla zasobu w repozytorium, takim jak baza danych. To zlecenie jest sparowane z .Unregister
Żądanie (rq) Pyta o zasób lub pyta o uprawnienia.
Uruchom ponownie (rt) Zatrzymuje operację, a następnie uruchamia ją ponownie. Na przykład polecenie Restart-Service cmdlet zatrzymuje, a następnie uruchamia usługę. Recyklingu
Wznów (ru) Uruchamia operację, która została wstrzymana. Na przykład polecenie Resume-Service cmdlet uruchamia usługę, która została wstrzymana. To zlecenie jest sparowane z .Suspend
Start (sa) Inicjuje operację. Na przykład polecenie Start-Service cmdlet uruchamia usługę. To zlecenie jest sparowane z .Stop Uruchamianie, inicjowanie, rozruch
Zatrzymaj (sp) Przerywa działanie. To zlecenie jest sparowane z .Start End, Kill, Terminate, Cancel
Prześlij (sb) Przedstawia zasób do zatwierdzenia. Wpis
Wstrzymywanie (ss) Wstrzymuje działanie. Na przykład polecenie Suspend-Service cmdlet wstrzymuje usługę. To zlecenie jest sparowane z .Resume Wstrzymanie
Odinstaluj (usa) Usuwa zasób z wskazanej lokalizacji. To zlecenie jest sparowane z .Install
Wyrejestruj (Twój) Usuwa wpis dla zasobu z repozytorium. To zlecenie jest sparowane z .Register Usuń
Oczekiwanie (w) Wstrzymuje operację do momentu wystąpienia określonego zdarzenia. Na przykład polecenie Wait-Job cmdlet wstrzymuje operacje do momentu ukończenia co najmniej jednego zadania w tle. Uśpienie, wstrzymywanie

Czasowniki zabezpieczeń

Program PowerShell używa klasy System.Management.Automation.VerbsSecurity do definiowania akcji, które mają zastosowanie do zabezpieczeń. W poniższej tabeli wymieniono większość zdefiniowanych zleceń.

Czasownik (alias) Akcja Synonimy, których należy unikać
Blokuj (bl) Ogranicza dostęp do zasobu. To zlecenie jest sparowane z .Unblock Zapobieganie, Ograniczanie, Odmawianie
Grant (gr) Umożliwia dostęp do zasobu. To zlecenie jest sparowane z .Revoke Zezwalaj, Włącz
Ochrona (pt) Chroni zasób przed atakiem lub utratą. To zlecenie jest sparowane z .Unprotect Szyfrowanie, ochrona, zapieczętowania
Odwołaj (rk) Określa akcję, która nie zezwala na dostęp do zasobu. To zlecenie jest sparowane z .Grant Usuń, wyłącz
Odblokowanie (ul) Usuwa ograniczenia dotyczące zasobu. To zlecenie jest sparowane z .Block Wyczyść, Zezwalaj
Niechronione (w górę) Usuwa zabezpieczenia z dodanego zasobu, aby zapobiec jego atakowi lub utracie. To zlecenie jest sparowane z .Protect Odszyfrowywanie, odszyfrowywanie

Inne czasowniki

Program PowerShell używa klasy System.Management.Automation.VerbsOther do definiowania kanonicznych nazw czasowników, które nie mieszczą się w określonej kategorii nazw czasowników, takich jak typowe, komunikacyjne, dane, cykl życia lub czasowniki zabezpieczeń.

Czasownik (alias) Akcja Synonimy, których należy unikać
Użyj (u) Używa lub zawiera zasób, aby coś zrobić.

Zobacz też