A PowerShell-parancsok jóváhagyott műveletei

A PowerShell egy főnévpárt használ a parancsmagok neveihez és a származtatott .NET-osztályokhoz. A név igerésze azonosítja a parancsmag által végrehajtott műveletet. A név főnévrésze azonosítja azt az entitást, amelyen a műveletet végrehajtják. A Get-Command parancsmag például lekéri a PowerShellben regisztrált összes parancsot.

Megjegyzés

A PowerShell az igét használja egy olyan szó leírására, amely műveletre utal akkor is, ha ez a szó nem az angol nyelvű szokásos igék. A kifejezés New például egy érvényes PowerShell-igenév, mert műveletre utal annak ellenére, hogy nem az angol nyelvű ige.

Minden jóváhagyott ige rendelkezik egy megfelelő aliaselőtaggal, definiálva. Ezt az alias-előtagot az aliasokban használjuk az adott igét használó parancsokhoz. Az Import alias-előtagja például ip, és ennek megfelelően a Import-Module aliasa ipmo. Ez egy javaslat, de nem szabály; különösen nem kell figyelembe venni a más környezetekből jól ismert parancsokat utánzó parancs aliasokat.

Az ige elnevezésére vonatkozó javaslatok

Az alábbi javaslatok segítenek kiválasztani a parancsmaghoz megfelelő parancsmagot, hogy konzisztenciát biztosítson a létrehozott parancsmagok, a PowerShell által biztosított parancsmagok és a mások által tervezett parancsmagok között.

  • A PowerShell által megadott előre definiált igenevek egyikének használata
  • Az igével írja le a művelet általános hatókörét, és használja a paramétereket a parancsmag műveletének további finomításához.
  • Ne használjon jóváhagyott igék szinonimát. Például mindig használja a Remove, soha ne használja Delete vagy Eliminate.
  • Csak az ebben a témakörben felsorolt igék formáját használja. Például használja Get, de ne használja Getting vagy Gets.
  • Ne használja a következő fenntartott igéket vagy aliasokat. A PowerShell nyelve és néhány parancsmag kivételes körülmények között használja ezeket az igéket.
    • ForEach (foreach)
    • Ping (pi)
    • Sort (sr)
    • Tee (te)
    • Where (wh)

Az igék teljes listáját a Get-Verb parancsmaggal szerezheti be.

Hasonló ige különböző műveletekhez

A következő hasonló igék különböző műveleteket jelölnek.

New és Add

A New ige használatával hozzon létre egy új erőforrást. A Add használatával hozzáadhat valamit egy meglévő tárolóhoz vagy erőforráshoz. Például Add-Content kimenetet ad hozzá egy meglévő fájlhoz.

New és Set

A New ige használatával hozzon létre egy új erőforrást. Set Az ige használatával módosíthatja a meglévő erőforrást, ha nem létezik, szükség esetén létrehozhatja azt, például a Set-Variable parancsmagot.

A Find ige használatával keressen egy objektumot. A Search ige használatával hozzon létre egy hivatkozást egy tárolóban lévő erőforrásra.

Get és Read

Az Get ige segítségével információkat szerezhet be egy erőforrásról (például egy fájlról), vagy beszerezhet egy objektumot, amellyel a jövőben hozzáférhet az erőforráshoz. A Read ige használatával nyisson meg egy erőforrást, és kinyerje a benne található információkat.

Invoke és Start

A Invoke paranccsal szinkron műveleteket hajthat végre, például futtathat egy parancsot, és megvárhatja, amíg befejeződik. Az Start ige használatával aszinkron műveleteket kezdhet, például autonóm folyamatokat indíthat el.

Ping és Test

Használja a Test igét.

Gyakori igék

A PowerShell a System.Management.Automation.VerbsCommon enumerálási osztályt használja a szinte bármilyen parancsmagra alkalmazható általános műveletek definiálásához. Az alábbi táblázat a legtöbb definiált igét felsorolja.

Ige (alias) Akció Elkerülendő szinonimák
Add (a) Erőforrást ad hozzá egy tárolóhoz, vagy egy elemet egy másik elemhez csatol. A Add-Content parancsmag például tartalmat ad hozzá egy fájlhoz. Ez az ige Removevan párosítva. Append, Attach, ConcatenateInsert
Clear (cl) Eltávolítja az összes erőforrást egy tárolóból, de nem törli a tárolót. A parancsmag például eltávolítja egy fájl tartalmát, Clear-Content de nem törli a fájlt. Flush, Erase, Release, UnmarkUnsetNullify
Close (cs) Módosítja egy erőforrás állapotát, hogy elérhetetlenné, elérhetetlenné vagy használhatatlanná tegye azt. Ez az ige párosítva van Open.
Copy (cp) Erőforrás másolása másik névre vagy egy másik tárolóba. A Copy-Item parancsmag például átmásolt egy elemet (például egy fájlt) az adattár egyik helyről egy másik helyre. Duplicate, Clone, ReplicateSync
Enter (et) Olyan műveletet ad meg, amely lehetővé teszi a felhasználó számára az erőforrásba való áthelyezést. A Enter-PSSession parancsmag például interaktív munkamenetbe helyezi a felhasználót. Ez az ige Exitvan párosítva. Push, Into
Exit (ex) Az aktuális környezetet vagy környezetet a legutóbb használt környezetre állítja. A Exit-PSSession parancsmag például az interaktív munkamenet indításához használt munkamenetbe helyezi a felhasználót. Ez az ige Entervan párosítva. Pop, Out
Find (fd) Ismeretlen, hallgatólagos, nem kötelező vagy megadott objektumot keres egy tárolóban. Search
Format (f) Objektumok elrendezése megadott formában vagy elrendezésben
Get (g) Egy erőforrást lekérő műveletet határoz meg. Ez az ige Setvan párosítva. Read, Open, Cat, Type, DirObtain, Dump, Acquire, Examine, , FindSearch
Hide (h) Egy erőforrás nem észlelhetővé válik. Például egy parancsmag, amelynek a neve tartalmazza az Elrejtés parancsot, elrejthet egy szolgáltatást egy felhasználó elől. Ez az ige Showvan párosítva. Block
Join (j) Az erőforrásokat egyetlen erőforrásba egyesíti. A Join-Path parancsmag például egyetlen elérési út létrehozásához egyesíti az elérési utat az egyik gyermekútvonalával. Ez az ige Splitvan párosítva. Combine, Unite, ConnectAssociate
Lock (lk) Egy erőforrás biztonságossá tételét biztosítja. Ez az ige Unlockvan párosítva. Restrict, Secure
Move (m) Erőforrás áthelyezése egyik helyről a másikra. A Move-Item parancsmag például áthelyez egy elemet az adattár egyik helyről egy másik helyre. \, \, \
New (n) Létrehoz egy erőforrást. (A Set ige adatokkal ( például a Set-Variable parancsmaggal) rendelkező erőforrás létrehozásakor is használható.) Create, Generate, Build, Make, , Allocate
Open (op) Módosíthatja az erőforrás állapotát, hogy akadálymentessé, elérhetővé vagy használhatóvá tegye azt. Ez az ige Closevan párosítva.
Optimize (om) Növeli az erőforrás hatékonyságát.
Pop (pop) Eltávolít egy elemet a verem tetejéről. A Pop-Location parancsmag például az aktuális helyet a verembe legutóbb leküldött helyre módosítja.
Push (pu) Egy elemet ad hozzá egy verem tetejére. A Push-Location parancsmag például a verembe küldi az aktuális helyet.
Redo (re) Visszaállít egy erőforrást a visszavont állapotba.
Remove (r) Erőforrás törlése egy tárolóból. A Remove-Variable parancsmag például töröl egy változót és annak értékét. Ez az ige Addvan párosítva. Clear, Cut, Dispose, Discard, , Erase
Rename (rn) Módosítja az erőforrás nevét. A tárolt adatok eléréséhez használt Rename-Item parancsmag például megváltoztatja az adattárban lévő elem nevét. Change
Reset (rs) Visszaállít egy erőforrást az eredeti állapotába.
Resize (rz) Erőforrás méretének módosítása.
Search (sr) Egy tárolóban lévő erőforrásra mutató hivatkozást hoz létre. Find, Locate
Select (sc) Egy erőforrást keres egy tárolóban. A Select-String parancsmag például sztringekben és fájlokban talál szöveget. Find, Locate
Set (s) Lecseréli egy meglévő erőforrás adatait, vagy létrehoz egy olyan erőforrást, amely adatokat tartalmaz. A Set-Date parancsmag például módosítja a rendszeridőt a helyi számítógépen. (A New ige is használható erőforrás létrehozásához.) Ez az ige Getvan párosítva. Write, Reset, Assign, Configure, , Update
Show (sh) Az erőforrást láthatóvá teszi a felhasználó számára. Ez az ige Hidevan párosítva. Display, Produce
Skip (sk) Egy vagy több erőforrást vagy pontot egymás után halad át. Bypass, Jump
Split (sl) Az erőforrás részeit választja el egymástól. A Split-Path parancsmag például az elérési út különböző részeit adja vissza. Ez az ige Joinvan párosítva. Separate
Step (st) Lépés a következő pontra vagy erőforrásra egy sorozatban.
Switch (sw) Olyan műveletet ad meg, amely két erőforrás között vált, például két hely, felelősség vagy állapot közötti váltásra.
Undo (un) Beállít egy erőforrást az előző állapotára.
Unlock (uk) Zárolt erőforrást ad ki. Ez az ige Lockvan párosítva. \, \, \
Watch (wc) Folyamatosan vizsgálja meg vagy figyeli az erőforrásokat a változásokhoz.

Kommunikációs igék

A PowerShell a System.Management.Automation.VerbsCommunications osztály használatával határozza meg a kommunikációra vonatkozó műveleteket. Az alábbi táblázat a legtöbb definiált igét felsorolja.

Ige (alias) Akció Elkerülendő szinonimák
Connect (cc) Kapcsolatot hoz létre egy forrás és egy cél között. Ez az ige Disconnectvan párosítva. \, \, \
Disconnect (dc) Megszakítja a forrás és a cél közötti kapcsolatot. Ez az ige Connectvan párosítva. Break, Logoff
Read (rd) Információkat szerez be egy forrásból. Ez az ige Writevan párosítva. \, \, \
Receive (rc) Fogadja a forrásból küldött információkat. Ez az ige Sendvan párosítva. \, \, \
Send (sd) Adatokat továbbít egy célhelyre. Ez az ige Receivevan párosítva. Put, Broadcast, MailFax
Write (wr) Adatokat ad hozzá egy célhoz. Ez az ige Readvan párosítva. Put, Print

Adat verbs

A PowerShell a System.Management.Automation.VerbsData osztály használatával határozza meg az adatkezelésre vonatkozó műveleteket. Az alábbi táblázat a legtöbb definiált igét felsorolja.

Ige neve (alias) Akció Elkerülendő szinonimák
Backup (ba) Az adatokat replikálással tárolja. Save, Burn, ReplicateSync
Checkpoint (ch) Pillanatképet készít az adatok vagy azok konfigurációjának aktuális állapotáról. Diff
Compare (cr) Kiértékeli az egyik erőforrás adatait egy másik erőforrás adataival. Diff
Compress (cm) Egy erőforrás adatait tömöríti. Párok Expand. Compact
Convert (cv) Ha a parancsmag támogatja a kétirányú átalakítást, vagy ha a parancsmag támogatja a több adattípus közötti átalakítást, az egyik ábrázolásról a másikra módosítja az adatokat. \, \, \
ConvertFrom (cf) Egy elsődleges bemenettípust konvertál (a parancsmag főnév a bemenetet jelzi) egy vagy több támogatott kimeneti típussá. \, \, \
ConvertTo (ct) Egy vagy több bemeneti típusból elsődleges kimeneti típussá alakítja át (a parancsmag főnév a kimeneti típust jelöli). \, \, \
Dismount (dm) Leválaszt egy elnevezett entitást egy helyről. Ez az ige Mountvan párosítva. Unmount, Unlink
Edit (ed) A meglévő adatok módosítása tartalom hozzáadásával vagy eltávolításával. \, \, \
Expand (en) Visszaállítja az eredeti állapotba tömörített erőforrás adatait. Ez az ige Compressvan párosítva. Explode, Uncompress
Export (ep) Az elsődleges bemenetet egy állandó adattárba, például egy fájlba vagy egy csereformátumba ágyazza be. Ez az ige Importvan párosítva. Extract, Backup
Group (gp) Egy vagy több erőforrás elrendezése vagy társítása
Import (ip) Állandó adattárban (például fájlban) vagy csereformátumban tárolt adatokból hoz létre erőforrást. A parancsmag például Import-Csv adatokat importál egy vesszővel tagolt értékfájlból (CSV) olyan objektumokba, amelyeket más parancsmagok használhatnak. Ez az ige Exportvan párosítva. BulkLoad, Load
Initialize (in) Előkészít egy erőforrást a használatra, és beállítja azt egy alapértelmezett állapotra. Erase, Init, Renew, RebuildReinitializeSetup
Limit (l) Korlátozások alkalmazása egy erőforrásra. Quota
Merge (mg) Egyetlen erőforrást hoz létre több erőforrásból. Combine, Join
Mount (mt) Elnevezett entitást csatol egy helyhez. Ez az ige Dismountvan párosítva. Connect
Out (o) Adatokat küld a környezetből. A Out-Printer parancsmag például adatokat küld egy nyomtatónak.
Publish (pb) Elérhetővé tesz egy erőforrást mások számára. Ez az ige Unpublishvan párosítva. \, \, \
Restore (rr) Előre definiált állapotba állít be egy erőforrást, például egy Checkpointáltal beállított állapotot. A Restore-Computer parancsmag például elindítja a rendszer visszaállítását a helyi számítógépen. Repair, Return, UndoFix
Save (sv) Megőrzi az adatokat a veszteség elkerülése érdekében.
Sync (sy) Biztosítja, hogy két vagy több erőforrás ugyanabban az állapotban van. \, \, \
Unpublish (ub) Az erőforrás elérhetetlenné válik mások számára. Ez az ige Publishvan párosítva. \, \, \
Update (ud) Egy erőforrás up-todátumot hoz az állapot, a pontosság, a megfelelőség vagy a megfelelőség fenntartásához. A Update-FormatData parancsmag például frissíti és formázófájlokat ad hozzá az aktuális PowerShell-konzolhoz. Refresh, Renew, RecalculateRe-index

Diagnosztikai igék

A PowerShell a System.Management.Automation.VerbsDiagnostic osztályt használja a diagnosztikára vonatkozó műveletek definiálásához. Az alábbi táblázat a legtöbb definiált igét felsorolja.

Ige (alias) Akció Elkerülendő szinonimák
Debug (db) Megvizsgálja az erőforrást a működési problémák diagnosztizálásához. Diagnose
Measure (ms) Azonosítja a megadott művelet által felhasznált erőforrásokat, vagy lekéri egy erőforrás statisztikáit. \, \, \
Ping (pi) Elavult – Használja inkább a Teszt igét.
Repair (rp) Erőforrás visszaállítása használható állapotba Fix, Restore
Resolve (rv) Az erőforrás rövidített ábrázolását teljesebb ábrázolásúra képezi le. Expand, Determine
Test (t) Ellenőrzi egy erőforrás működését vagy konzisztenciáját. Diagnose, Analyze, SalvageVerify
Trace (tr) Nyomon követi egy erőforrás tevékenységeit. Track, Follow, InspectDig

Életciklus-igék

A PowerShell a System.Management.Automation.VerbsLifecycle osztályt használja az erőforrás életciklusára vonatkozó műveletek meghatározásához. Az alábbi táblázat a legtöbb definiált igét felsorolja.

Ige (alias) Akció Elkerülendő szinonimák
Approve (ap) Megerősíti vagy elfogadja egy erőforrás vagy folyamat állapotát.
Assert (as) Megerősíti az erőforrás állapotát. Certify
Build (bd) Létrehoz egy összetevőt (általában bináris vagy dokumentumot) bizonyos bemeneti fájlokból (általában forráskódból vagy deklaratív dokumentumokból).) Ez az ige a PowerShell 6-ban lett hozzáadva.
Complete (cp) Befejez egy műveletet.
Confirm (cn) Egy erőforrás vagy folyamat állapotát nyugtázza, ellenőrzi vagy ellenőrzi. Acknowledge, Agree, Certify, Validate, , Verify
Deny (dn) Elutasítja, letiltja vagy ellenzi egy erőforrás vagy folyamat állapotát. Block, Object, RefuseReject
Deploy (dp) Alkalmazásokat, webhelyeket vagy megoldásokat küld egy távoli célhelynek úgy, hogy a megoldás felhasználói az üzembe helyezés befejezése után elérhessék azt. Ez az ige a PowerShell 6-ban lett hozzáadva.
Disable (d) Egy erőforrást nem elérhető vagy inaktív állapotba konfigurál. A Disable-PSBreakpoint parancsmag például inaktívvá tesz egy töréspontot. Ez az ige Enablevan párosítva. Halt, Hide
Enable (e) Egy erőforrást egy elérhető vagy aktív állapotba konfigurál. A Enable-PSBreakpoint parancsmag például aktívvá tesz egy töréspontot. Ez az ige Disablevan párosítva. Start, Begin
Install (is) Elhelyez egy erőforrást egy helyen, és igény szerint inicializálja azt. Ez az ige Uninstallvan párosítva. Setup
Invoke (i) Végrehajt egy műveletet, például parancsot vagy metódust futtat. Run, Start
Register (rg) Létrehoz egy bejegyzést egy erőforráshoz egy adattárban, például egy adatbázisban. Ez az ige Unregistervan párosítva.
Request (rq) Erőforrást kér, vagy engedélyeket kér.
Restart (rt) Leállítja a műveletet, majd újra elindítja. A Restart-Service parancsmag például leáll, majd elindít egy szolgáltatást. Recycle
Resume (ru) Felfüggesztett műveletet indít el. A Resume-Service parancsmag például egy felfüggesztett szolgáltatást indít el. Ez az ige Suspendvan párosítva.
Start (sa) Műveletet kezdeményez. A Start-Service parancsmag például elindít egy szolgáltatást. Ez az ige Stopvan párosítva. \, \, \
Stop (sp) Megszüntet egy tevékenységet. Ez az ige Startvan párosítva. End, Kill, TerminateCancel
Submit (sb) Egy erőforrást jelenít meg jóváhagyásra. Post
Suspend (ss) Szüneteltet egy tevékenységet. A Suspend-Service parancsmag például szüneteltet egy szolgáltatást. Ez az ige Resumevan párosítva. Pause
Uninstall (us) Eltávolít egy erőforrást egy megadott helyről. Ez az ige Installvan párosítva.
Unregister (ur) Eltávolítja egy erőforrás bejegyzését egy adattárból. Ez az ige Registervan párosítva. Remove
Wait (w) Egy művelet szüneteltetése egy adott esemény bekövetkeztéig. A Wait-Job parancsmag például szünetelteti a műveleteket, amíg egy vagy több háttérfeladat be nem fejeződik. Sleep, Pause

Biztonsági parancsok

A PowerShell a System.Management.Automation.VerbsSecurity osztályt használja a biztonságra vonatkozó műveletek meghatározásához. Az alábbi táblázat a legtöbb definiált igét felsorolja.

Ige (alias) Akció Elkerülendő szinonimák
Block (bl) Korlátozza az erőforráshoz való hozzáférést. Ez az ige Unblockvan párosítva. \, \, \
Grant (gr) Lehetővé teszi az erőforráshoz való hozzáférést. Ez az ige Revokevan párosítva. Allow, Enable
Protect (pt) Védi az erőforrásokat a támadástól vagy a veszteségtől. Ez az ige Unprotectvan párosítva. \, \, \
Revoke (rk) Olyan műveletet határoz meg, amely nem teszi lehetővé az erőforráshoz való hozzáférést. Ez az ige Grantvan párosítva. Remove, Disable
Unblock (ul) Eltávolítja az erőforrásra vonatkozó korlátozásokat. Ez az ige Blockvan párosítva. Clear, Allow
Unprotect (up) Eltávolítja a biztonsági elemet egy hozzáadott erőforrásból, hogy megakadályozza a támadást vagy a veszteséget. Ez az ige Protectvan párosítva. Decrypt, Unseal

Egyéb igék

A PowerShell a System.Management.Automation.VerbsOther osztályt használja olyan vesszővel rendelkező igenevek definiálására, amelyek nem illeszkednek egy adott igenévkategóriába, például a gyakori, kommunikációs, adat-, életciklus- vagy biztonsági igenevekhez.

Ige (alias) Akció Elkerülendő szinonimák
Use (u) Erőforrást használ vagy tartalmaz valamilyen műveletet.

Lásd még: