Sdílet prostřednictvím

Schválená slovesa pro příkazy PowerShellu

  • Článek

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á termín sloveso k popisu slova, které implikuje akci, i když toto slovo není standardní sloveso v anglickém jazyce. Výraz Nový je například platný název příkazu PowerShellu, protože napovídá akci, i když není slovesem 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žijte 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 (pí)
    • Řazení (sr)
    • Tee (te)
    • Kde (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.

Nový vs. Přidat

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.

Nové vs. nastavení

Pomocí příkazu New vytvořte nový prostředek. Pomocí příkazu Set upravte existující prostředek, volitelně ho vytvořte, pokud neexistuje, například rutina Set-Variable.

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

Získání vs. čtení

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.

Vyvolání vs. spuštění

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
Přidat (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í
Vymazat (cl) Odebere všechny prostředky z kontejneru, ale neodstraní kontejner. Například rutina Clear-Content odebere obsah souboru, ale soubor neodstraní. Flush, Erase, Release, Unmark, Unset, Nullify
Zavřít (cs) Změní stav prostředku tak, aby byl nepřístupný, nedostupný nebo nepoužitelný. Tento příkaz je spárovaný s Open.
kopírovat (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 (např. 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. Pop, Out
Najít (fd) Vyhledá objekt v kontejneru, který je neznámý, implicitní, volitelný nebo zadaný. Hledání
formátu (f) Uspořádá objekty v zadaném formuláři nebo rozložení.
Získat (g) Určuje akci, která načte prostředek. Toto sloveso je spárováno s Set. Read, Open, Cat, Type, Dir, Obtain, Dump, Acquire, Examine, Find, Search
skrýt (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
Připojit se k (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í
Přesunout (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
Nový (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í
Otevřít (op) Změní stav prostředku tak, aby byl přístupný, dostupný nebo použitelný. Toto sloveso je spárováno s Close.
Optimalizovat (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.
Znovu (re) Obnoví prostředek do stavu, který byl vrácen zpět.
Odebrat (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
Přejmenovat (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
resetování (rs) Nastaví prostředek zpět do původního stavu.
změna velikosti(rz) Změní velikost prostředku.
hledání (sr) Vytvoří odkaz na prostředek v kontejneru. Najít, najít
Vybrat (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
Zobrazit (sh) Zviditelní prostředek uživateli. Toto sloveso je spárováno s Hide. Zobrazení, výroba
přeskočit (sk) Obchází jeden nebo více prostředků nebo bodů v posloupnosti. Obejití, přeskakování
Rozdělení (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ý
krok (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.
vrátit zpět (un) Nastaví prostředek na předchozí stav.
Odemknout (Uk) Uvolní prostředek, který byl uzamčen. Toto sloveso je spárováno s Lock. Release, Unrestrict, Unsecure
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í
Odpojit (DC) Přeruší propojení mezi zdrojem a cílem. Toto sloveso je spárováno s Connect. Break, Logoff
čtení (rd) Získá informace ze zdroje. Toto sloveso je spárováno s Write. Získání, výzva, získání
příjem (rc) Přijímá informace odeslané ze zdroje. Toto sloveso je spárováno s Send. Číst, Přijmout, Náhled
Odeslat (sd) Doručí informace do cíle. Toto sloveso je spárováno s Receive. Put, Broadcast, Mail, Fax
zápisu (wr) Přidá informace do cíle. Toto sloveso je spárováno s Read. Put, Print

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
zálohování (ba) Ukládá data tím, že je replikuje. Ukládání, vypalování, replikace, synchronizace
kontrolní bod (ch) Vytvoří snímek aktuálního stavu dat nebo jeho konfigurace. Rozdíl
Compare (cr) Vyhodnotí data z jednoho prostředku proti datům z jiného prostředku. Rozdíl
Komprimovat (cm) Zkomprimuje data prostředku. Páry s Expand. kompaktní
Převést (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
odpojení (dm) Odpojte pojmenovanou entitu od umístění. Toto sloveso je spárováno s Mount. Odpojení, zrušení propojení
upravit (ed) Upraví existující data přidáním nebo odebráním obsahu. Změna, aktualizace, změna
Rozbalit (en) Obnoví data prostředku, který byl komprimován do původního stavu. Toto sloveso je spárováno s Compress. Explode, Uncompress
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í
skupiny (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. Například rutina Import-Csv importuje data ze souboru hodnot oddělených čárkami (CSV) na objekty, které můžou používat jiné rutiny. Toto sloveso je spárováno s Export. BulkLoad, Load
inicializace (v) Připraví prostředek pro použití a nastaví ho na výchozí stav. Erase, Init, Renew, Rebuild, Reinitialize, Setup
limit (l) Použije omezení pro prostředek. Kvóta
sloučení (mg) Vytvoří jeden prostředek z více prostředků. Kombinování, spojení
přípojné (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.
Publikovat (pb) Zpřístupní prostředek ostatním. Toto sloveso je spárováno s Unpublish. Nasazení, vydání, instalace
obnovení (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
Uložit (sv) Zachovává data, aby nedošlo ke ztrátě.
Synchronizace (sy) Zaručuje, že dva nebo více prostředků jsou ve stejném stavu. Replikace, replikace, shoda
zrušit publikování (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. Refresh, Renew, Recalculate, Re-index

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
ladění (db) Prozkoumá prostředek pro diagnostiku provozních problémů. Diagnostikovat
míry (ms) Identifikuje prostředky spotřebované zadanou operací nebo načte statistiky o prostředku. Výpočet, určení, analýza
ping (pí) Zastaralé – místo toho použijte příkaz Test.
Oprava (rp) Obnoví prostředek do použitelné podmínky. Oprava, obnovení
Vyřešit (rv) Mapuje zkrácenou reprezentaci prostředku na ucelenější reprezentaci. Rozbalit, určit
testovací (t) Ověřuje operaci nebo konzistenci prostředku. Diagnostika, analýza, salvage, ověření
trasování (tr) Sleduje aktivity prostředku. Track, Follow, Inspect, Dig

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
schválit (ap) Potvrdí nebo souhlasí se stavem prostředku nebo procesu.
Assert (as) Potvrzuje stav prostředku. Certify
sestavení (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.
Dokončení (cp) Ukončí operaci.
Potvrdit (cn) Bere na vědomí, ověřuje nebo ověřuje stav prostředku nebo procesu. Potvrzení, souhlas, certifikace, ověření, ověření
Odepřít (dn) Odmítne, objekty, bloky nebo odporuje stavu prostředku nebo procesu. Block, Object, Reject, Reject
Nasazení (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.
Zakázat (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
Povolit (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. Start, Begin
instalace (je) Umístí prostředek do umístění a volitelně ho inicializuje. Toto sloveso je spárováno s Uninstall. Nastavení
Vyvolání (i) Provede akci, například spuštění příkazu nebo metody. Spustit, Spustit
Zaregistrovat (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í.
Restartování (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í
zastavení (sp) Ukončí aktivitu. Toto sloveso je spárováno s Start. End, Kill, Terminate, Cancel
Odeslat (sb) Zobrazí zdroj ke schválení. Příspěvek
pozastavit (ss) Pozastaví aktivitu. Například rutina Suspend-Service pozastaví službu. Toto sloveso je spárováno s Resume. Pauza
Odinstalace (nás) Odebere prostředek z určeného umístění. Toto sloveso je spárováno s Install.
zrušit registraci (vaše) Odebere položku prostředku z úložiště. Toto sloveso je spárováno s Register. Odstranit
čekání (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
blok (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
Chránit (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í
odvolání (rk) Určuje akci, která nepovoluje přístup k prostředku. Toto sloveso je spárováno s Grant. Odebrat, zakázat
Odblokovat (ul) Odebere omezení prostředku. Toto sloveso je spárováno s Block. Vymazat, Povolit
Odemknout (nahoru) 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á System.Management.Automation.VerbsOther třídu k definování kanonických názvů sloves, které se nevejdou do konkrétní kategorie názvů sloves, jako jsou běžná, komunikace, data, životní cyklus nebo názvy sloves zabezpečení.

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

Viz také