Sdílet prostřednictvím

Schválená slovesa pro příkazy PowerShellu

PowerShell používá dvojici sloves-podstatné jméno pro názvy rutin a pro jejich odvozené třídy .NET. Slovesná část názvu identifikuje akci, kterou rutina provede. Podstatná část názvu identifikuje entitu, na které se akce provádí. Například rutina Get-Command načte všechny příkazy, které jsou zaregistrované v PowerShellu.

Poznámka:

PowerShell používá sloveso k popisu slova, které znamená akci, i když toto slovo není standardní sloveso v anglickém jazyce. Termín je například platný název příkazu PowerShellu, New protože napovídá akci, i když se nejedná o sloveso v anglickém jazyce.

Každá schválená operace má odpovídající předponu aliasu definována. Tuto předponu aliasu používáme v aliasech pro příkazy, které používají tento příkaz. Například předpona aliasu pro Import je ip a alias pro Import-Module je ipmo. Toto je doporučení, ale ne pravidlo; zejména nemusí být respektována pro aliasy příkazů mimicking dobře známých příkazů z jiných prostředí.

Doporučení pro pojmenování sloves

Následující doporučení vám pomůžou zvolit odpovídající příkaz pro vaši rutinu, abyste zajistili konzistenci mezi vytvořenými rutinami, rutinami, které poskytuje PowerShell, a rutinami navrženými jinými uživateli.

  • Použití jednoho z předdefinovaných názvů sloves poskytovaných PowerShellem
  • Příkaz použijte k popisu obecného rozsahu akce a použití parametrů k dalšímu upřesnění akce.
  • Nepoužívejte synonymum schváleného příkazu. Například vždy používejte Remove, nikdy nepoužívejte Delete nebo Eliminate.
  • Používejte pouze tvar každého slovesa uvedeného v tomto tématu. Například použijte Get, ale nepoužívejte Getting nebo Gets.
  • Nepoužívejte následující rezervované příkazy ani aliasy. Jazyk PowerShellu a málo rutin tyto příkazy používají za výjimečných okolností.
    • ForEach (foreach)
    • Ping (pi)
    • Sort (sr)
    • Tee (te)
    • Where (wh)

Pomocí rutiny Get-Verb můžete získat úplný seznam sloves.

Podobné příkazy pro různé akce

Následující podobné příkazy představují různé akce.

New Vs. Add

Pomocí příkazu New vytvořte nový prostředek. Pomocí Add můžete něco přidat do existujícího kontejneru nebo prostředku. Například Add-Content přidá výstup do existujícího souboru.

New Vs. Set

Pomocí příkazu New vytvořte nový prostředek. Set Příkaz použijte k úpravě existujícího prostředku, případně ho vytvořte, pokud neexistuje, například rutinuSet-Variable.

Pomocí příkazu Find vyhledejte objekt. Pomocí příkazu Search vytvořte odkaz na prostředek v kontejneru.

Get Vs. Read

Pomocí příkazu Get získejte informace o prostředku (například souboru) nebo získejte objekt, se kterým budete mít v budoucnu přístup k prostředku. Pomocí příkazu Read otevřete prostředek a extrahujte informace obsažené v něm.

Invoke Vs. Start

Pomocí příkazu Invoke proveďte synchronní operace, jako je spuštění příkazu a čekání na jeho ukončení. Pomocí příkazu Start zahajte asynchronní operace, jako je spuštění autonomního procesu.

Ping Vs. Test

Použijte příkaz Test.

Běžné příkazy

PowerShell používá System.Management.Automation.VerbsCommon třídu výčtu k definování obecných akcí, které se dají použít na téměř jakoukoli rutinu. Následující tabulka uvádí většinu definovaných sloves.

Sloveso (alias) Činnost Synonyma, kterým se chcete vyhnout
Add (a) Přidá prostředek do kontejneru nebo připojí položku k jiné položce. Například rutina Add-Content přidá obsah do souboru. Toto sloveso je spárováno s Remove. Připojení, Připojení, Zřetězení, Vložení
Clear (cl) Odebere všechny prostředky z kontejneru, ale neodstraní kontejner. Například Clear-Content rutina odebere obsah souboru, ale neodstraní ho. Vyprázdnit, Vymazat, Uvolnit, Zrušit označení, Zrušit, Vynulovat
Close (cs) Změní stav prostředku tak, aby byl nepřístupný, nedostupný nebo nepoužitelný. Tento příkaz je spárovaný s Open.
Copy (cp) Zkopíruje prostředek do jiného názvu nebo do jiného kontejneru. Například rutina Copy-Item zkopíruje položku (například soubor) z jednoho umístění v úložišti dat do jiného umístění. Duplikování, klonování, replikace, synchronizace
Enter (et) Určuje akci, která uživateli umožní přejít do prostředku. Například rutina Enter-PSSession umístí uživatele do interaktivní relace. Toto sloveso je spárováno s Exit. Nasdílení, do
Exit (ex) Nastaví aktuální prostředí nebo kontext na naposledy použitý kontext. Například rutina Exit-PSSession umístí uživatele do relace, která byla použita ke spuštění interaktivní relace. Toto sloveso je spárováno s Enter. Vyskočit, vystoupit
Find (fd) Vyhledá objekt v kontejneru, který je neznámý, implicitní, nepovinný nebo zadaný. Search
Format (f) Uspořádá objekty v zadaném formuláři nebo rozložení.
Get (g) Určuje akci, která načte prostředek. Toto sloveso je spárováno s Set. číst, otevřít, kočka, typ, dir, získat, výpis, získat, prozkoumat, najít, hledat
Hide (h) Vytvoří prostředek jako nedetekovatelný. Například rutina, jejíž název obsahuje příkaz Skrýt, může skrýt službu od uživatele. Toto sloveso je spárováno s Show. Blokovat
Join (j) Kombinuje prostředky do jednoho prostředku. Například rutina Join-Path kombinuje cestu s jednou z podřízených cest a vytvoří jednu cestu. Toto sloveso je spárováno s Split. Kombinování, sjednocení, připojení, přidružení
Lock (lk) Zabezpečuje prostředek. Toto sloveso je spárováno s Unlock. Omezení, zabezpečení
Move (m) Přesune prostředek z jednoho umístění do jiného. Například rutina Move-Item přesune položku z jednoho umístění v úložišti dat do jiného umístění. Přenos, název, migrace
New (n) Vytvoří prostředek. (Příkaz Set lze použít také při vytváření prostředku, který obsahuje data, například rutinu Set-Variable.) Vytvoření, generování, sestavení, vytvoření, přidělení
Open (op) Změní stav prostředku tak, aby byl přístupný, dostupný nebo použitelný. Toto sloveso je spárováno s Close.
Optimize (om) Zvyšuje efektivitu prostředku.
Pop (pop) Odebere položku z horní části zásobníku. Například rutina Pop-Location změní aktuální umístění na umístění, které bylo naposledy vloženo do zásobníku.
Push (pu) Přidá položku na začátek zásobníku. Například rutina Push-Location odešle aktuální umístění do zásobníku.
Redo (re) Obnoví prostředek do stavu, který byl vrácen zpět.
Remove (r) Odstraní prostředek z kontejneru. Například rutina Remove-Variable odstraní proměnnou a její hodnotu. Toto sloveso je spárováno s Add. Vymazat, Vyjmout, Odstranit, Zahodit, Vymazat
Rename (rn) Změní název prostředku. Například rutina Rename-Item, která se používá pro přístup k uloženým datům, změní název položky v úložišti dat. Změna
Reset (rs) Nastaví prostředek zpět do původního stavu.
Resize(rz) Změní velikost prostředku.
Search (sr) Vytvoří odkaz na prostředek v kontejneru. Najít, najít
Select (sc) Vyhledá prostředek v kontejneru. Například rutina Select-String najde text v řetězcích a souborech. Najít, najít
Set (s) Nahradí data u existujícího prostředku nebo vytvoří prostředek, který obsahuje některá data. Například rutina Set-Date změní systémový čas na místním počítači. (Příkaz New lze také použít k vytvoření prostředku.) Toto sloveso je spárováno s Get. Zápis, resetování, přiřazení, konfigurace, aktualizace
Show (sh) Zviditelní prostředek uživateli. Toto sloveso je spárováno s Hide. Zobrazení, výroba
Skip (sk) Obchází jeden nebo více prostředků nebo bodů v posloupnosti. Obejití, přeskakování
Split (sl) Odděluje části prostředku. Například rutina Split-Path vrací různé části cesty. Toto sloveso je spárováno s Join. Oddělený
Step (st) Přesune se do dalšího bodu nebo prostředku v posloupnosti.
Switch (sw) Určuje akci, která se liší mezi dvěma prostředky, například změnou mezi dvěma umístěními, zodpovědnostmi nebo stavy.
Undo (un) Nastaví prostředek na předchozí stav.
Unlock (uk) Uvolní prostředek, který byl uzamčen. Toto sloveso je spárováno s Lock. Uvolnění, Neomezit, Nezabezpečeno
Watch (wc) Průběžně kontroluje nebo monitoruje změny prostředků.

Komunikační příkazy

PowerShell používá System.Management.Automation.VerbsCommunications třídu k definování akcí, které se vztahují na komunikaci. Následující tabulka uvádí většinu definovaných sloves.

Sloveso (alias) Činnost Synonyma, kterým se chcete vyhnout
Connect (cc) Vytvoří propojení mezi zdrojem a cílem. Toto sloveso je spárováno s Disconnect. Připojení, Telnet, přihlášení
Disconnect (dc) Přeruší propojení mezi zdrojem a cílem. Toto sloveso je spárováno s Connect. Přestávka, odhlášení
Read (rd) Získá informace ze zdroje. Toto sloveso je spárováno s Write. Získání, výzva, získání
Receive (rc) Přijímá informace odeslané ze zdroje. Toto sloveso je spárováno s Send. Číst, Přijmout, Náhled
Send (sd) Doručí informace do cíle. Toto sloveso je spárováno s Receive. Put, Broadcast, Mail, Fax
Write (wr) Přidá informace do cíle. Toto sloveso je spárováno s Read. Odeslat, vytisknout

Příkazy pro data

PowerShell používá třídu System.Management.Automation.VerbsData k definování akcí, které se vztahují na zpracování dat. Následující tabulka uvádí většinu definovaných sloves.

Název slovesa (alias) Činnost Synonyma, kterým se chcete vyhnout
Backup (ba) Ukládá data tím, že je replikuje. Ukládání, vypalování, replikace, synchronizace
Checkpoint (ch) Vytvoří snímek aktuálního stavu dat nebo jeho konfigurace. Diff
Compare (cr) Vyhodnotí data z jednoho prostředku proti datům z jiného prostředku. Diff
Compress (cm) Zkomprimuje data prostředku. Páry s Expand. kompaktní
Convert (cv) Změní data z jedné reprezentace na jinou, když rutina podporuje obousměrný převod nebo když rutina podporuje převod mezi více datovými typy. Změna, změna velikosti, převzorkování
ConvertFrom (cf) Převede jeden primární typ vstupu (podstatná jméno rutiny označuje vstup) na jeden nebo více podporovaných výstupních typů. Export, výstup, out
ConvertTo (ct) Převede z jednoho nebo více typů vstupu na primární výstupní typ (podstatné jméno rutiny označuje typ výstupu). Import, vstup, in
Dismount (dm) Odpojte pojmenovanou entitu od umístění. Toto sloveso je spárováno s Mount. Odpojení, zrušení propojení
Edit (ed) Upraví existující data přidáním nebo odebráním obsahu. Změna, aktualizace, změna
Expand (en) Obnoví data prostředku, který byl komprimován do původního stavu. Toto sloveso je spárováno s Compress. Rozložit, Uvolnit
Export (ep) Zapouzdřuje primární vstup do trvalého úložiště dat, například do souboru nebo do zaměnitelného formátu. Toto sloveso je spárováno s Import. Extrakce, zálohování
Group (gp) Uspořádá nebo přidruží jeden nebo více prostředků.
Import (ip) Vytvoří prostředek z dat uložených v trvalém úložišti dat (například v souboru) nebo ve formátu výměny. Rutina Import-Csv například importuje data ze souboru hodnotCSV oddělených čárkami do objektů, které můžou používat jiné rutiny. Toto sloveso je spárováno s Export. BulkLoad, Load
Initialize (in) Připraví prostředek pro použití a nastaví ho na výchozí stav. Vymazat, Initovat, Obnovit, Znovu sestavit, Znovu inicializovat, Nastavení
Limit (l) Použije omezení pro prostředek. Kvóta
Merge (mg) Vytvoří jeden prostředek z více prostředků. Kombinování, spojení
Mount (mt) Připojí pojmenovanou entitu k umístění. Toto sloveso je spárováno s Dismount. Připojit
Out (o) Odesílá data z prostředí. Například rutina Out-Printer odesílá data do tiskárny.
Publish (pb) Zpřístupní prostředek ostatním. Toto sloveso je spárováno s Unpublish. Nasazení, vydání, instalace
Restore (rr) Nastaví prostředek na předdefinovaný stav, například stav nastavený Checkpoint. Například rutina Restore-Computer spustí obnovení systému v místním počítači. Oprava, vrácení, vrácení zpět, oprava
Save (sv) Zachovává data, aby nedošlo ke ztrátě.
Sync (sy) Zaručuje, že dva nebo více prostředků jsou ve stejném stavu. Replikace, replikace, shoda
Unpublish (ub) Znepřístupňuje prostředek ostatním. Toto sloveso je spárováno s Publish. Odinstalace, vrácení, skrytí
Update (ud) Přináší up-toprostředku, aby se zachoval stav, přesnost, shoda nebo dodržování předpisů. Například rutina Update-FormatData aktualizuje a přidá formátovací soubory do aktuální konzoly PowerShellu. Obnovit, obnovit, přepočítat, přeindexovat

Diagnostické příkazy

PowerShell používá System.Management.Automation.VerbsDiagnostic třídu k definování akcí, které se vztahují na diagnostiku. Následující tabulka uvádí většinu definovaných sloves.

Sloveso (alias) Činnost Synonyma, kterým se chcete vyhnout
Debug (db) Prozkoumá prostředek pro diagnostiku provozních problémů. Diagnostikovat
Measure (ms) Identifikuje prostředky spotřebované zadanou operací nebo načte statistiky o prostředku. Výpočet, určení, analýza
Ping (pi) Zastaralé – místo toho použijte příkaz Test.
Repair (rp) Obnoví prostředek do použitelné podmínky. Oprava, obnovení
Resolve (rv) Mapuje zkrácenou reprezentaci prostředku na ucelenější reprezentaci. Rozbalit, určit
Test (t) Ověřuje operaci nebo konzistenci prostředku. Diagnostika, analýza, salvage, ověření
Trace (tr) Sleduje aktivity prostředku. Sledovat, sledovat, kontrolovat, kopat

Příkazy životního cyklu

PowerShell používá System.Management.Automation.VerbsLifecycle třídu k definování akcí, které se vztahují na životní cyklus prostředku. Následující tabulka uvádí většinu definovaných sloves.

Sloveso (alias) Činnost Synonyma, kterým se chcete vyhnout
Approve (ap) Potvrdí nebo souhlasí se stavem prostředku nebo procesu.
Assert (as) Potvrzuje stav prostředku. Osvědčit
Build (bd) Vytvoří artefakt (obvykle binární soubor nebo dokument) ze sady vstupních souborů (obvykle zdrojový kód nebo deklarativní dokumenty).) Toto sloveso bylo přidáno v PowerShellu 6.
Complete (cp) Ukončí operaci.
Confirm (cn) Bere na vědomí, ověřuje nebo ověřuje stav prostředku nebo procesu. Potvrzení, souhlas, certifikace, ověření, ověření
Deny (dn) Odmítne, objekty, bloky nebo odporuje stavu prostředku nebo procesu. Block, Object, Reject, Reject
Deploy (dp) Odešle aplikaci, web nebo řešení do vzdáleného cíle tak, aby k ní po dokončení nasazení měl přístup příjemce tohoto řešení. Toto sloveso bylo přidáno v PowerShellu 6.
Disable (d) Nakonfiguruje prostředek do nedostupného nebo neaktivního stavu. Například rutina Disable-PSBreakpoint znepřístupňuje zarážku. Toto sloveso je spárováno s Enable. Zastavit, skrýt
Enable (e) Nakonfiguruje prostředek do dostupného nebo aktivního stavu. Například rutina Enable-PSBreakpoint aktivuje zarážku. Toto sloveso je spárováno s Disable. Začátek, začátek
Install (is) Umístí prostředek do umístění a volitelně ho inicializuje. Toto sloveso je spárováno s Uninstall. Nastavení
Invoke (i) Provede akci, například spuštění příkazu nebo metody. Spustit, Spustit
Register (rg) Vytvoří položku pro prostředek v úložišti, jako je například databáze. Toto sloveso je spárováno s Unregister.
Request (rq) Požádá o prostředek nebo požádá o oprávnění.
Restart (rt) Zastaví operaci a pak ji znovu spustí. Například rutina Restart-Service zastaví a pak spustí službu. Recyklovat
Resume (ru) Spustí operaci, která byla pozastavena. Například rutina Resume-Service spustí službu, která byla pozastavena. Toto sloveso je spárováno s Suspend.
Start (sa) Inicializuje operaci. Například rutina Start-Service spustí službu. Toto sloveso je spárováno s Stop. Spuštění, spuštění, spuštění
Stop (sp) Ukončí aktivitu. Toto sloveso je spárováno s Start. Ukončit, zabít, ukončit, zrušit
Submit (sb) Zobrazí zdroj ke schválení. Příspěvek
Suspend (ss) Pozastaví aktivitu. Například rutina Suspend-Service pozastaví službu. Toto sloveso je spárováno s Resume. Pauza
Uninstall (us) Odebere prostředek z určeného umístění. Toto sloveso je spárováno s Install.
Unregister (ur) Odebere položku prostředku z úložiště. Toto sloveso je spárováno s Register. Odstranit
Wait (w) Pozastaví operaci, dokud nedojde k zadané události. Například rutina Wait-Job pozastaví operace, dokud nebude dokončena jedna nebo více úloh na pozadí. Spánek, pozastavení

Příkazy zabezpečení

PowerShell používá třídu System.Management.Automation.VerbsSecurity k definování akcí, které platí pro zabezpečení. Následující tabulka uvádí většinu definovaných sloves.

Sloveso (alias) Činnost Synonyma, kterým se chcete vyhnout
Block (bl) Omezuje přístup k prostředku. Toto sloveso je spárováno s Unblock. Prevence, omezení, odepření
Grant (gr) Umožňuje přístup k prostředku. Toto sloveso je spárováno s Revoke. Povolit, Povolit
Protect (pt) Chrání prostředek před útokem nebo ztrátou. Toto sloveso je spárováno s Unprotect. Šifrování, ochrana, zapečetění
Revoke (rk) Určuje akci, která nepovoluje přístup k prostředku. Toto sloveso je spárováno s Grant. Odebrat, zakázat
Unblock (ul) Odebere omezení prostředku. Toto sloveso je spárováno s Block. Vymazat, Povolit
Unprotect (up) Odebere ochranu z přidaného prostředku, aby se zabránilo útoku nebo ztrátě. Toto sloveso je spárováno s Protect. Dešifrování, zrušení

Další příkazy

PowerShell používá třídu System.Management.Automation.VerbsOther k definování kanonických názvů sloves, které se nevejdou do konkrétní kategorie názvů sloves, jako jsou běžné názvy, komunikace, data, životní cyklus nebo názvy sloves zabezpečení.

Sloveso (alias) Činnost Synonyma, kterým se chcete vyhnout
Use (u) K něčemu slouží nebo zahrnuje prostředek.

Viz také

  • Last updated on