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. Append, Attach, , ConcatenateInsert
Clear (cl) Odebere všechny prostředky z kontejneru, ale neodstraní kontejner. Například Clear-Content rutina odebere obsah souboru, ale neodstraní ho. Flush, Erase, Release, Unmark, , UnsetNullify
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í. Duplicate, Clone, , ReplicateSync
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. Push, Into
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. Pop, Out
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. Read, Open, , Cat, DirExamineTypeObtainDumpAcquire, FindSearch
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. Block
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. Combine, Unite, , ConnectAssociate
Lock (lk) Zabezpečuje prostředek. Toto sloveso je spárováno s Unlock. Restrict, Secure
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í. Transfer, , NameMigrate
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.) Create, Generate, Build, , MakeAllocate
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. Clear, Cut, Dispose, , DiscardErase
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. Change
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. Find, Locate
Select (sc) Vyhledá prostředek v kontejneru. Například rutina Select-String najde text v řetězcích a souborech. Find, Locate
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. Write, Reset, Assign, , ConfigureUpdate
Show (sh) Zviditelní prostředek uživateli. Toto sloveso je spárováno s Hide. Display, Produce
Skip (sk) Obchází jeden nebo více prostředků nebo bodů v posloupnosti. Bypass, Jump
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. Separate
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. Release, , UnrestrictUnsecure
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. Join, , TelnetLogin
Disconnect (dc) Přeruší propojení mezi zdrojem a cílem. Toto sloveso je spárováno s Connect. Break, Logoff
Read (rd) Získá informace ze zdroje. Toto sloveso je spárováno s Write. Acquire, , PromptGet
Receive (rc) Přijímá informace odeslané ze zdroje. Toto sloveso je spárováno s Send. Read, , AcceptPeek
Send (sd) Doručí informace do cíle. Toto sloveso je spárováno s Receive. Put, Broadcast, , MailFax
Write (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
Backup (ba) Ukládá data tím, že je replikuje. Save, Burn, , ReplicateSync
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. Compact
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. Change, , ResizeResample
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, , OutputOut
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, , InputIn
Dismount (dm) Odpojte pojmenovanou entitu od umístění. Toto sloveso je spárováno s Mount. Unmount, Unlink
Edit (ed) Upraví existující data přidáním nebo odebráním obsahu. Change, , UpdateModify
Expand (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. Extract, Backup
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. Erase, Init, Renew, Rebuild, , ReinitializeSetup
Limit (l) Použije omezení pro prostředek. Quota
Merge (mg) Vytvoří jeden prostředek z více prostředků. Combine, Join
Mount (mt) Připojí pojmenovanou entitu k umístění. Toto sloveso je spárováno s Dismount. Connect
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. Deploy, , ReleaseInstall
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. Repair, Return, , UndoFix
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. Replicate, , CoerceMatch
Unpublish (ub) Znepřístupňuje prostředek ostatním. Toto sloveso je spárováno s Publish. Uninstall, , RevertHide
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, , RecalculateRe-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
Debug (db) Prozkoumá prostředek pro diagnostiku provozních problémů. Diagnose
Measure (ms) Identifikuje prostředky spotřebované zadanou operací nebo načte statistiky o prostředku. Calculate, , DetermineAnalyze
Ping (pi) Zastaralé – místo toho použijte příkaz Test.
Repair (rp) Obnoví prostředek do použitelné podmínky. Fix, Restore
Resolve (rv) Mapuje zkrácenou reprezentaci prostředku na ucelenější reprezentaci. Expand, Determine
Test (t) Ověřuje operaci nebo konzistenci prostředku. Diagnose, Analyze, , SalvageVerify
Trace (tr) Sleduje aktivity prostředku. Track, Follow, , InspectDig

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. Certify
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. Acknowledge, Agree, Certify, , ValidateVerify
Deny (dn) Odmítne, objekty, bloky nebo odporuje stavu prostředku nebo procesu. Block, Object, , RefuseReject
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. Halt, Hide
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. Start, Begin
Install (is) Umístí prostředek do umístění a volitelně ho inicializuje. Toto sloveso je spárováno s Uninstall. Setup
Invoke (i) Provede akci, například spuštění příkazu nebo metody. Run, Start
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. Recycle
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. Launch, , InitiateBoot
Stop (sp) Ukončí aktivitu. Toto sloveso je spárováno s Start. End, Kill, , TerminateCancel
Submit (sb) Zobrazí zdroj ke schválení. Post
Suspend (ss) Pozastaví aktivitu. Například rutina Suspend-Service pozastaví službu. Toto sloveso je spárováno s Resume. Pause
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. Remove
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í. Sleep, Pause

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. Prevent, , LimitDeny
Grant (gr) Umožňuje přístup k prostředku. Toto sloveso je spárováno s Revoke. Allow, Enable
Protect (pt) Chrání prostředek před útokem nebo ztrátou. Toto sloveso je spárováno s Unprotect. Encrypt, , SafeguardSeal
Revoke (rk) Určuje akci, která nepovoluje přístup k prostředku. Toto sloveso je spárováno s Grant. Remove, Disable
Unblock (ul) Odebere omezení prostředku. Toto sloveso je spárováno s Block. Clear, Allow
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. Decrypt, Unseal

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