Udostępnij za pomocą

Zatwierdzone czasowniki dla poleceń programu PowerShell

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

Uwaga

Program PowerShell używa czasownika terminowego, aby opisać słowo, które oznacza akcję, nawet jeśli to słowo nie jest standardowym czasownikiem w języku angielskim. Na przykład termin New jest prawidłową nazwą czasownika programu PowerShell, ponieważ oznacza akcję, mimo że nie jest to czasownik w języku angielskim.

Każde zatwierdzone zlecenie ma zdefiniowany odpowiedni prefiks aliasu . Używamy tego prefiksu aliasu w aliasach dla poleceń używających tego czasownika. Na przykład prefiks aliasu dla Import jest ip, a w związku z tym alias Import-Module jest ipmo. Jest to zalecenie, ale nie reguła; w szczególności nie należy go przestrzegać w przypadku aliasów poleceń naśladujących dobrze znane polecenia z innych środowisk.

Zalecenia dotyczące nazewnictwa czasowników

Poniższe zalecenia pomagają wybrać odpowiednie zlecenie dla polecenia cmdlet, aby zapewnić spójność między utworzonymi poleceniami cmdlet, poleceniami cmdlet udostępnianymi przez program PowerShell i poleceniami cmdlet zaprojektowanymi przez inne osoby.

  • Używanie jednej ze wstępnie zdefiniowanych nazw czasowników udostępnianych przez program PowerShell
  • Użyj czasownika , aby opisać ogólny zakres akcji i użyć parametrów, aby dokładniej uściślić akcję polecenia cmdlet.
  • Nie używaj synonimu zatwierdzonego zlecenia. Na przykład zawsze używaj Remove, nigdy nie używaj Delete ani Eliminate.
  • Użyj tylko postaci każdego zlecenia wymienionego w tym temacie. Na przykład użyj polecenia Get, ale nie używaj Getting polecenia lub Gets.
  • Nie używaj następujących zarezerwowanych czasowników ani aliasów. Język programu PowerShell i rzadkie polecenia cmdlet używają tych czasowników w wyjątkowych okolicznościach.
    • ForEach (foreach)
    • Ping (pi)
    • Sort (sr)
    • Tee (te)
    • Where (wh)

Pełną listę zleceń można uzyskać przy użyciu polecenia cmdlet Get-Verb.

Podobne czasowniki dla różnych akcji

Poniższe podobne czasowniki reprezentują różne akcje.

New a Add

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

New a Set

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

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

Get a Read

Użyj czasownika Get, aby uzyskać informacje o zasobie (takim jak plik) lub uzyskać obiekt, 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.

Invoke a Start

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 wyliczania System.Management.Automation.VerbsCommon, aby zdefiniować akcje ogólne, które mogą mieć zastosowanie do niemal dowolnego polecenia cmdlet. W poniższej tabeli wymieniono większość zdefiniowanych zleceń.

Czasownik (alias) Akcja Synonimy, których należy unikać
Add (a) Dodaje zasób do kontenera lub dołącza element do innego elementu. Na przykład polecenie cmdlet Add-Content dodaje zawartość do pliku. To zlecenie jest sparowane z Remove. Dołączanie, dołączanie, łączenie, wstawianie
Clear (cl) Usuwa wszystkie zasoby z kontenera, ale nie usuwa kontenera. Na przykład polecenie cmdlet usuwa zawartość pliku, Clear-Content ale nie usuwa pliku. Opróżnianie, wymazywanie, zwalnianie, odznaczanie, nieustawione, unieważnianie
Close (cs) Zmienia stan zasobu, aby był niedostępny, niedostępny lub bezużyteczny. To zlecenie jest sparowane z Open.
Copy (cp) Kopiuje zasób do innej nazwy lub innego kontenera. Na przykład polecenie cmdlet Copy-Item kopiuje element (taki jak plik) z jednej lokalizacji w magazynie danych do innej lokalizacji. Duplikowanie, klonowanie, replikowanie, synchronizacja
Enter (et) Określa akcję, która umożliwia użytkownikowi przejście do zasobu. Na przykład polecenie cmdlet Enter-PSSession umieszcza użytkownika w sesji interaktywnej. To zlecenie jest sparowane z Exit. Wypychanie, do
Exit (ex) Ustawia bieżące środowisko lub kontekst na ostatnio używany kontekst. Na przykład polecenie cmdlet Exit-PSSession umieszcza użytkownika w sesji, która została użyta do rozpoczęcia sesji interaktywnej. To zlecenie jest sparowane z Enter. Trzask, Na zewnątrz
Find (fd) Szuka obiektu w kontenerze, który jest nieznany, dorozumiany, opcjonalny lub określony. Search
Format (f) Rozmieszcza obiekty w określonym formularzu lub układzie
Get (g) Określa akcję, która pobiera zasób. To zlecenie jest sparowane z Set. Odczytywanie, otwieranie, kot, typ, dir, uzyskiwanie, zrzut, uzyskiwanie, badanie, znajdowanie, wyszukiwanie
Hide (h) Sprawia, że zasób jest niezdefiniowalny. Na przykład polecenie cmdlet, którego nazwa zawiera czasownik Hide, może ukryć usługę od użytkownika. To zlecenie jest sparowane z Show. Blok
Join (j) Łączy zasoby w jeden zasób. Na przykład polecenie cmdlet Join-Path łączy ścieżkę z jedną ze ścieżek podrzędnych w celu utworzenia pojedynczej ścieżki. To zlecenie jest sparowane z Split. Łączenie, Unite, Łączenie, Kojarzenie
Lock (lk) Zabezpiecza zasób. To zlecenie jest sparowane z Unlock. Ograniczanie, zabezpieczanie
Move (m) Przenosi zasób z jednej lokalizacji do innej. Na przykład polecenie cmdlet Move-Item przenosi element z jednej lokalizacji w magazynie danych do innej lokalizacji. Transfer, Nazwa, Migrowanie
New (n) Tworzy zasób. (Czasownik Set może być również używany podczas tworzenia zasobu zawierającego dane, takie jak polecenie cmdlet Set-Variable). Tworzenie, generowanie, kompilowanie, przydzielanie
Open (op) Zmienia stan zasobu, aby był dostępny, dostępny lub dostępny. To zlecenie jest sparowane z Close.
Optimize (om) Zwiększa skuteczność zasobu.
Pop (pop) Usuwa element z góry stosu. Na przykład polecenie cmdlet Pop-Location zmienia bieżącą lokalizację na lokalizację, która została ostatnio wypchnięta do stosu.
Push (pu) Dodaje element w górnej części stosu. Na przykład polecenie cmdlet Push-Location wypycha bieżącą lokalizację do stosu.
Redo (re) Resetuje zasób do stanu, który został cofniętą.
Remove (r) Usuwa zasób z kontenera. Na przykład polecenie cmdlet Remove-Variable usuwa zmienną i jej wartość. To zlecenie jest sparowane z Add. Czyszczenie, wycinanie, usuwanie, odrzucanie, wymazywanie
Rename (rn) Zmienia nazwę zasobu. Na przykład polecenie cmdlet Rename-Item, które służy do uzyskiwania dostępu do przechowywanych danych, zmienia nazwę elementu w magazynie danych. Zmiana
Reset (rs) Ustawia zasób z powrotem na jego oryginalny stan.
Resize(rz) Zmienia rozmiar zasobu.
Search (sr) Tworzy odwołanie do zasobu w kontenerze. Znajdź, znajdź
Select (sc) Lokalizuje zasób w kontenerze. Na przykład polecenie cmdlet Select-String znajduje tekst w ciągach i plikach. Znajdź, znajdź
Set (s) Zastępuje dane w istniejącym zasobie lub tworzy zasób zawierający pewne dane. Na przykład polecenie cmdlet Set-Date zmienia czas systemowy na komputerze lokalnym. (Czasownik New można również użyć do utworzenia zasobu). To zlecenie jest sparowane z Get. Pisanie, resetowanie, przypisywanie, konfigurowanie, aktualizowanie
Show (sh) Sprawia, że zasób jest widoczny dla użytkownika. To zlecenie jest sparowane z Hide. Wyświetlanie, tworzenie
Skip (sk) Pomija co najmniej jeden zasób lub punkty w sekwencji. Obejście, przeskocz
Split (sl) Oddziela części zasobu. Na przykład polecenie cmdlet Split-Path zwraca różne części ścieżki. To zlecenie jest sparowane z Join. Oddzielać
Step (st) Przechodzi do następnego punktu lub zasobu w sekwencji.
Switch (sw) Określa akcję, która zmienia się między dwoma zasobami, takimi jak zmiana między dwiema lokalizacjami, obowiązkami lub stanami.
Undo (un) Ustawia zasób na poprzedni stan.
Unlock (uk) Zwalnia zasób, który został zablokowany. To zlecenie jest sparowane z Lock. Wydanie, Unrestrict, Unsecure
Watch (wc) Stale sprawdza lub monitoruje zasób pod kątem zmian.

Czasowniki komunikacji

Program PowerShell używa klasy System.Management.Automation.VerbsCommunications w celu zdefiniowania akcji mających zastosowanie do komunikacji. W poniższej tabeli wymieniono większość zdefiniowanych zleceń.

Czasownik (alias) Akcja Synonimy, których należy unikać
Connect (cc) Tworzy połączenie między źródłem a miejscem docelowym. To zlecenie jest sparowane z Disconnect. Dołącz, Telnet, Zaloguj się
Disconnect (dc) Przerywa połączenie między źródłem a miejscem docelowym. To zlecenie jest sparowane z Connect. Przerwanie, wylogowywanie
Read (rd) Pobiera informacje ze źródła. To zlecenie jest sparowane z Write. Uzyskiwanie, monit, pobieranie
Receive (rc) Akceptuje informacje wysyłane ze źródła. To zlecenie jest sparowane z Send. Odczytywanie, akceptowanie, podgląd
Send (sd) Dostarcza informacje do miejsca docelowego. To zlecenie jest sparowane z Receive. Umieszczenie, transmisja, poczta, faks
Write (wr) Dodaje informacje do obiektu docelowego. To zlecenie jest sparowane z Read. Umieść, drukuj

Czasowniki danych

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

Nazwa zlecenia (alias) Akcja Synonimy, których należy unikać
Backup (ba) Przechowuje dane, replikując je. Zapisywanie, nagrywanie, replikowanie, synchronizacja
Checkpoint (ch) Tworzy migawkę bieżącego stanu danych lub jego konfiguracji. Diff
Compare (cr) Oblicza dane z jednego zasobu względem danych z innego zasobu. Diff
Compress (cm) Kompaktuje dane zasobu. Pary z Expand. Kompaktowy
Convert (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, ponowne próbkowanie
ConvertFrom (cf) Konwertuje jeden podstawowy typ danych wejściowych (nazwa 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 jednego lub większej liczby typów danych wejściowych na podstawowy typ danych wyjściowych (nazwa polecenia cmdlet wskazuje typ danych wyjściowych). Importowanie, wprowadzanie danych wejściowych, in
Dismount (dm) Odłącza nazwaną jednostkę od lokalizacji. To zlecenie jest sparowane z Mount. Odinstalowywanie, odłączanie
Edit (ed) Modyfikuje istniejące dane, dodając lub usuwając zawartość. Zmienianie, aktualizowanie, modyfikowanie
Expand (en) Przywraca dane zasobu, który został skompresowany do stanu pierwotnego. To zlecenie jest sparowane z Compress. Eksploduj, nieskompresuj
Export (ep) Hermetyzuje podstawowe dane wejściowe do trwałego magazynu danych, takiego jak plik lub w formacie wymiany. To zlecenie jest sparowane z Import. Wyodrębnianie, tworzenie kopii zapasowej
Group (gp) Rozmieszcza lub kojarzy co najmniej jeden zasób
Import (ip) Tworzy zasób na podstawie danych przechowywanych w trwałym magazynie danych (takim jak plik) lub w formacie wymiany. Na przykład Import-Csv polecenie cmdlet importuje dane z pliku wartości rozdzielanej przecinkami (CSV) do obiektów, które mogą być używane przez inne polecenia cmdlet. To zlecenie jest sparowane z Export. Ładunek masowy, Obciążenie
Initialize (in) Przygotowuje zasób do użycia i ustawia go na stan domyślny. Wymazywanie, inicjowanie, odnawianie, ponowne inicjowanie, konfigurowanie
Limit (l) Stosuje ograniczenia do zasobu. Kwota
Merge (mg) Tworzy jeden zasób z wielu zasobów. Łączenie, sprzężenia
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 cmdlet Out-Printer wysyła dane do drukarki.
Publish (pb) Udostępnia zasób innym osobom. To zlecenie jest sparowane z Unpublish. Wdrażanie, wydawanie, instalowanie
Restore (rr) Ustawia zasób na wstępnie zdefiniowany stan, taki jak stan ustawiony przez Checkpoint. Na przykład polecenie cmdlet Restore-Computer uruchamia przywracanie systemu na komputerze lokalnym. Naprawianie, zwracanie, cofanie, naprawianie
Save (sv) Zachowuje dane, aby uniknąć utraty.
Sync (sy) Zapewnia, że co najmniej dwa zasoby są w tym samym stanie. Replikowanie, współtworzenie, dopasowanie
Unpublish (ub) Sprawia, że zasób jest niedostępny dla innych. To zlecenie jest sparowane z Publish. Odinstalowywanie, przywracanie, ukrywanie
Update (ud) Umożliwia up-tozasobów — data utrzymania stanu, dokładności, zgodności lub zgodności. Na przykład polecenie cmdlet Update-FormatData 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ć
Debug (db) Analizuje zasób w celu zdiagnozowania problemów operacyjnych. Diagnozować
Measure (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 użytecznego Poprawka, przywracanie
Resolve (rv) Mapuje skróconą reprezentację zasobu na bardziej pełną reprezentację. Rozwiń, określ
Test (t) Weryfikuje operację lub spójność zasobu. Diagnozowanie, analizowanie, odzyskiwanie, weryfikowanie
Trace (tr) Śledzi działania zasobu. Śledzenie, obserwowanie, inspekcja, kopanie

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ć
Approve (ap) Potwierdza lub zgadza się na stan zasobu lub procesu.
Assert (as) Potwierdza stan zasobu. Zaświadczam
Build (bd) Tworzy artefakt (zazwyczaj plik binarny lub dokument) z niektórych zestawów plików wejściowych (zazwyczaj kodu źródłowego lub dokumentów deklaratywnych). To zlecenie zostało dodane w programie PowerShell 6.
Complete (cp) Kończy operację.
Confirm (cn) Potwierdza, weryfikuje lub weryfikuje stan zasobu lub procesu. Potwierdzanie, zgadzanie się, certyfikowanie, weryfikowanie, weryfikowanie
Deny (dn) Odrzuca, obiekty, bloki lub sprzeciwia się stanowi zasobu lub procesu. Blokuj, obiekt, odrzucanie, odrzucanie
Deploy (dp) Wysyła aplikację, witrynę internetową lub rozwiązanie do lokalizacji docelowej zdalnej w taki sposób, aby użytkownik tego rozwiązania mógł uzyskać do niego dostęp po zakończeniu wdrażania. To zlecenie zostało dodane w programie PowerShell 6.
Disable (d) Konfiguruje zasób w stanie niedostępnym lub nieaktywnym. Na przykład polecenie cmdlet Disable-PSBreakpoint sprawia, że punkt przerwania jest nieaktywny. To zlecenie jest sparowane z Enable. Zatrzymaj, ukryj
Enable (e) Konfiguruje zasób do dostępnego lub aktywnego stanu. Na przykład polecenie cmdlet Enable-PSBreakpoint powoduje, że punkt przerwania jest aktywny. To zlecenie jest sparowane z Disable. Początek, początek
Install (is) Umieszcza zasób w lokalizacji i opcjonalnie inicjuje go. To zlecenie jest sparowane z Uninstall. Konfiguracja
Invoke (i) Wykonuje akcję, taką jak uruchomienie polecenia lub metody. Uruchamianie, uruchamianie
Register (rg) Tworzy wpis dla zasobu w repozytorium, takim jak baza danych. To zlecenie jest sparowane z Unregister.
Request (rq) Prosi o zasób lub prosi o uprawnienia.
Restart (rt) Zatrzymuje operację, a następnie uruchamia ją ponownie. Na przykład polecenie cmdlet Restart-Service zatrzymuje się, a następnie uruchamia usługę. Recyklingu
Resume (ru) Uruchamia operację, która została zawieszona. Na przykład polecenie cmdlet Resume-Service uruchamia usługę, która została zawieszona. To zlecenie jest sparowane z Suspend.
Start (sa) Inicjuje operację. Na przykład polecenie cmdlet Start-Service uruchamia usługę. To zlecenie jest sparowane z Stop. Uruchamianie, inicjowanie, rozruch
Stop (sp) Przerywa działanie. To zlecenie jest sparowane z Start. Koniec, zabicie, zakończenie, anulowanie
Submit (sb) Przedstawia zasób do zatwierdzenia. Post
Suspend (ss) Wstrzymuje działanie. Na przykład polecenie cmdlet Suspend-Service wstrzymuje usługę. To zlecenie jest sparowane z Resume. Wstrzymanie
Uninstall (us) Usuwa zasób ze wskazanej lokalizacji. To zlecenie jest sparowane z Install.
Unregister (ur) Usuwa wpis zasobu z repozytorium. To zlecenie jest sparowane z Register. Usuń
Wait (w) Wstrzymuje operację do momentu wystąpienia określonego zdarzenia. Na przykład polecenie cmdlet Wait-Job wstrzymuje operacje aż do ukończenia co najmniej jednego zadania w tle. Uśpienie, wstrzymywanie

Czasowniki zabezpieczeń

Program PowerShell używa klasy System.Management.Automation.VerbsSecurity w celu zdefiniowania akcji mających zastosowanie do zabezpieczeń. W poniższej tabeli wymieniono większość zdefiniowanych zleceń.

Czasownik (alias) Akcja Synonimy, których należy unikać
Block (bl) Ogranicza dostęp do zasobu. To zlecenie jest sparowane z Unblock. Zapobieganie, ograniczanie, odmowa
Grant (gr) Umożliwia dostęp do zasobu. To zlecenie jest sparowane z Revoke. Zezwalaj, Włącz
Protect (pt) Zabezpiecza zasób przed atakiem lub utratą. To zlecenie jest sparowane z Unprotect. Szyfrowanie, ochrona, pieczęć
Revoke (rk) Określa akcję, która nie zezwala na dostęp do zasobu. To zlecenie jest sparowane z Grant. Usuń, Wyłącz
Unblock (ul) Usuwa ograniczenia do zasobu. To zlecenie jest sparowane z Block. Wyczyść, Zezwalaj
Unprotect (up) Usuwa zabezpieczenia z zasobu, który został dodany, aby zapobiec jego atakom lub utracie. To zlecenie jest sparowane z Protect. Odszyfrowywanie, odsełowywanie

Inne czasowniki

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

Czasownik (alias) Akcja Synonimy, których należy unikać
Use (u) Używa lub zawiera zasób do wykonania.

Zobacz też

  • Last updated on