Zatwierdzone czasowniki dla poleceń programu PowerShell
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
Remove
używaj aniEliminate``Delete
. - Należy używać tylko formy każdego zlecenia wymienionego w tym temacie. Na przykład użyj ,
Get
ale nie używaj aniGetting
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 .
Znajdź a Wyszukaj
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ż
- System.Management.Automation.VerbsCommon
- System.Management.Automation.VerbsCommunications
- System.Management.Automation.VerbsData
- System.Management.Automation.VerbsDiagnostic
- System.Management.Automation.VerbsLifeCycle
- System.Management.Automation.VerbsSecurity
- System.Management.Automation.VerbsOther
- Deklaracja polecenia cmdlet
- Windows PowerShell — przewodnik programisty
- Windows PowerShell Shell SDK