Udostępnij za pośrednictwem

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. Append, , Attach, , ConcatenateInsert
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. Flush, , Erase, Release, Unmark, , UnsetNullify
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. Duplicate, , Clone, , ReplicateSync
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. Push, Into
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. Pop, Out
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. Read, Open, CatTypeDirObtainDumpAcquireExamineFindSearch
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. Block
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. Combine, , Unite, , ConnectAssociate
Lock (lk) Zabezpiecza zasób. To zlecenie jest sparowane z Unlock. Restrict, Secure
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, , NameMigrate
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). Create, , Generate, Build, , MakeAllocate
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. Clear, , Cut, Dispose, , DiscardErase
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. Change
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. Find, Locate
Select (sc) Lokalizuje zasób w kontenerze. Na przykład polecenie cmdlet Select-String znajduje tekst w ciągach i plikach. Find, Locate
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. Write, , Reset, Assign, , ConfigureUpdate
Show (sh) Sprawia, że zasób jest widoczny dla użytkownika. To zlecenie jest sparowane z Hide. Display, Produce
Skip (sk) Pomija co najmniej jeden zasób lub punkty w sekwencji. Bypass, Jump
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. Separate
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. Release, , UnrestrictUnsecure
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. Join, , TelnetLogin
Disconnect (dc) Przerywa połączenie między źródłem a miejscem docelowym. To zlecenie jest sparowane z Connect. Break, Logoff
Read (rd) Pobiera informacje ze źródła. To zlecenie jest sparowane z Write. Acquire, , PromptGet
Receive (rc) Akceptuje informacje wysyłane ze źródła. To zlecenie jest sparowane z Send. Read, , AcceptPeek
Send (sd) Dostarcza informacje do miejsca docelowego. To zlecenie jest sparowane z Receive. Put, , Broadcast, , MailFax
Write (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 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. Save, , Burn, , ReplicateSync
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. Compact
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. Change, , ResizeResample
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. Export, , OutputOut
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). Import, , InputIn
Dismount (dm) Odłącza nazwaną jednostkę od lokalizacji. To zlecenie jest sparowane z Mount. Unmount, Unlink
Edit (ed) Modyfikuje istniejące dane, dodając lub usuwając zawartość. Change, , UpdateModify
Expand (en) Przywraca dane zasobu, który został skompresowany do stanu pierwotnego. To zlecenie jest sparowane z Compress. Explode, Uncompress
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. Extract, Backup
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. BulkLoad, Load
Initialize (in) Przygotowuje zasób do użycia i ustawia go na stan domyślny. Erase, , Init, Renew, Rebuild, , ReinitializeSetup
Limit (l) Stosuje ograniczenia do zasobu. Quota
Merge (mg) Tworzy jeden zasób z wielu zasobów. Combine, Join
Mount (mt) Dołącza nazwaną jednostkę do lokalizacji. To zlecenie jest sparowane z Dismount. Connect
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. Deploy, , ReleaseInstall
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. Repair, , Return, , UndoFix
Save (sv) Zachowuje dane, aby uniknąć utraty.
Sync (sy) Zapewnia, że co najmniej dwa zasoby są w tym samym stanie. Replicate, , CoerceMatch
Unpublish (ub) Sprawia, że zasób jest niedostępny dla innych. To zlecenie jest sparowane z Publish. Uninstall, , RevertHide
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. Refresh, , Renew, , RecalculateRe-index

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. Diagnose
Measure (ms) Identyfikuje zasoby używane przez określoną operację lub pobiera statystyki dotyczące zasobu. Calculate, , DetermineAnalyze
Ping (pi) Przestarzałe — zamiast tego użyj czasownika Test.
Repair (rp) Przywraca zasób do warunku użytecznego Fix, Restore
Resolve (rv) Mapuje skróconą reprezentację zasobu na bardziej pełną reprezentację. Expand, Determine
Test (t) Weryfikuje operację lub spójność zasobu. Diagnose, , Analyze, , SalvageVerify
Trace (tr) Śledzi działania zasobu. Track, , Follow, , InspectDig

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. Certify
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. Acknowledge, , Agree, Certify, , ValidateVerify
Deny (dn) Odrzuca, obiekty, bloki lub sprzeciwia się stanowi zasobu lub procesu. Block, , Object, , RefuseReject
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. Halt, Hide
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. Start, Begin
Install (is) Umieszcza zasób w lokalizacji i opcjonalnie inicjuje go. To zlecenie jest sparowane z Uninstall. Setup
Invoke (i) Wykonuje akcję, taką jak uruchomienie polecenia lub metody. Run, Start
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ę. Recycle
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. Launch, , InitiateBoot
Stop (sp) Przerywa działanie. To zlecenie jest sparowane z Start. End, , Kill, , TerminateCancel
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. Pause
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. Remove
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. Sleep, Pause

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. Prevent, , LimitDeny
Grant (gr) Umożliwia dostęp do zasobu. To zlecenie jest sparowane z Revoke. Allow, Enable
Protect (pt) Zabezpiecza zasób przed atakiem lub utratą. To zlecenie jest sparowane z Unprotect. Encrypt, , SafeguardSeal
Revoke (rk) Określa akcję, która nie zezwala na dostęp do zasobu. To zlecenie jest sparowane z Grant. Remove, Disable
Unblock (ul) Usuwa ograniczenia do zasobu. To zlecenie jest sparowane z Block. Clear, Allow
Unprotect (up) Usuwa zabezpieczenia z zasobu, który został dodany, aby zapobiec jego atakom lub utracie. To zlecenie jest sparowane z Protect. Decrypt, Unseal

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