A PowerShell-parancsok jóváhagyott műveletei
A PowerShell a parancsmagok neveihez és a származtatott .NET-osztályaikhoz egy főnévpárot használ.
A parancsmag által végrehajtott műveletet a név verb része azonosítja. A név főnév része azonosítja azt az entitást, amelyen a művelet végre van hajtva. A parancsmag például Get-Command
lekéri a PowerShellben regisztrált összes parancsot.
Megjegyzés
A PowerShell az ige kifejezés használatával ír le egy olyan szót, amely egy műveletet jelent, még akkor is, ha ez a szó nem szabványos parancs az angol nyelvben. Az Új kifejezés például egy érvényes PowerShell-parancsnév, mivel egy műveletet jelent annak ellenére, hogy az nem angol nyelvű parancs.
Minden jóváhagyott művelethez meg van határozva egy megfelelő aliaselőtag . Ezt az aliaselőtagot aliasokként használjuk az ezzel az igével használt parancsokhoz. A aliaselőtagja Import
például a ip
, ennek megfelelően a aliasa Import-Module
ipmo
pedig . Ez egy javaslat, de nem szabály; különösen nem kell tiszteletben tartani a más környezetekben jól ismert parancsokat utánozni képes parancs aliasok esetében.
Igeelnevezési Javaslatok
Az alábbi javaslatok segítenek kiválasztani a parancsmag megfelelő parancsmagját, hogy biztosítsa a létrehozott parancsmagok, a PowerShell által biztosított parancsmagok és a mások által tervezett parancsmagok közötti konzisztenciát.
- A PowerShell által megadott előre definiált műveletek egyikének használata
- A parancs használatával leírhatja a művelet általános hatókörét, és paraméterek használatával tovább pontosíthatja a parancsmag műveletét.
- Ne használja a jóváhagyott ige szinonimát. Például mindig használja a et
Remove
, soha ne használja a vagyDelete
a etEliminate
. - Csak a témakörben felsorolt összes művelet formáját használja. Használja például a következőt
Get
: , de ne használja a vagy aGetting
etGets
. - Ne használja az alábbi fenntartott műveleteket vagy aliasokat. A PowerShell nyelv és néhány ritka parancsmag kivételes esetekben használja ezeket a műveleteket.
- ForEach (foreach)
- Pingelés (pi)
- Rendezés (sr)
- Tee (te)
- Hol (wh)
A parancsmag használatával lekért műveletek teljes Get-Verb
listája is lekért.
Hasonló műveletek különböző műveletekhez
Az alábbi hasonló műveletek különböző műveleteket képviselnek.
Új és hozzáadás
Az ige New
használatával hozzon létre egy új erőforrást. A használatával Add
hozzáadhat valamit egy meglévő tárolóhoz vagy erőforráshoz. A például kimenetet Add-Content
ad hozzá egy meglévő fájlhoz.
Új és set
Az ige New
használatával hozzon létre egy új erőforrást. A parancs Set
használatával módosíthat egy meglévő erőforrást, és igény szerint létrehozza, ha még nem létezik, Set-Variable
például a parancsmagot.
Keresés és keresés
Az ige Find
használatával keresse meg az objektumot. Az ige Search
használatával hozzon létre egy hivatkozást egy tárolóban található erőforrásra.
Beolvassa és elolvassa
A művelet Get
használatával információkat szerezhet be egy erőforrásról (például egy fájlról), vagy egy olyan objektumot szerezhet be, amellyel a jövőben hozzáférhet az erőforráshoz. A művelet Read
használatával megnyit egy erőforrást, és kinyeri a benne található információkat.
Meghívás és indítás
A parancs Invoke
használatával szinkron műveleteket hajt végre, például parancsokat futtat, és megvárja a futását. Az ige Start
használatával aszinkron műveleteket kezd el, például egy autonóm folyamatot.
Ping vs. Test
Használja az ige Test
.
Gyakori műveletek
A PowerShell a System.Management.Automation.VerbsCommon enumerálás osztály használatával határoz meg olyan általános műveleteket, amelyek szinte bármilyen parancsmagra alkalmazhatók. Az alábbi táblázat a legtöbb definiált műveletet felsorolja.
Művelet (alias) | Művelet | Kerülendő szinonimák |
---|---|---|
Hozzáadás (a) | Hozzáad egy erőforrást egy tárolóhoz, vagy egy elemet csatol egy másik elemhez. A parancsmag például Add-Content tartalmat ad hozzá egy fájlhoz. Ez az ige párban áll a sal Remove . |
Hozzáfűzés, csatolás, összefűzött, beszúrás |
Clear (cl) | Eltávolítja az összes erőforrást a tárolóból, de nem törli a tárolót. A parancsmag például Clear-Content eltávolítja egy fájl tartalmát, de nem törli a fájlt. |
Flush, Erase, Release, Unmark, Unset, Nullify |
Bezárás (cs) | Módosítja az erőforrás állapotát, hogy elérhetetlenné, elérhetetlenné vagy használhatatlanná tegye. Ez az ige párosítva van a Open. |
|
Másolás (cp) | Átmásol egy erőforrást egy másik névre vagy egy másik tárolóba. A parancsmag például Copy-Item átmásol egy elemet (például egy fájlt) az adattár egyik helyére. |
Duplikált, klónozás, replikálás, szinkronizálás |
Enter (et) | Egy műveletet ad meg, amely lehetővé teszi a felhasználó számára az erőforrásba való áthelyezést. A parancsmag például Enter-PSSession egy interaktív munkamenetbe teszi a felhasználót. Ez az ige párban áll a sal Exit . |
Push, Into |
Kilépés (például) | Az aktuális környezetet vagy környezetet a legutóbb használt környezetre állítja be. A parancsmag például Exit-PSSession az interaktív munkamenet elindítani használt munkamenetbe teszi a felhasználót. Ez az ige párban áll a sal Enter . |
Kiugró, kiugró |
Keresés (fd) | Egy ismeretlen, implicit, választható vagy megadott objektumot keres a tárolóban. | Keresés |
Formátum (f) | Egy megadott formában vagy elrendezésben rendezi el az objektumokat | |
Lekért (g) | Egy erőforrást lekért műveletet ad meg. Ez az ige párban áll a sal Set . |
Read, Open, Cat, Type, Dir, Obtain, Dump, Acquire, Examine, Find, Search |
Elrejtés (h) | Az erőforrást nem észrevehetővé teszi. Egy olyan parancsmag például, amelynek a neve tartalmazza az Elrejtés parancsmagot, a felhasználó szolgáltatását is megadhatja. Ez az ige párban áll a sal Show . |
Letiltás |
Csatlakozás (j) | Egyetlen erőforrásban egyesíti az erőforrásokat. A parancsmag például Join-Path egy elérési utat kombinál az egyik gyermekútvonalával egyetlen elérési út létrehozásához. Ez az ige párban áll a sal Split . |
Combine, Unite, Csatlakozás, Associate |
Zárolás (lk) | Biztosít egy erőforrást. Ez az ige és a párja Unlock . |
Korlátozás, biztonság |
Áthelyezés (m) | Áthelyez egy erőforrást az egyik helyről a másikra. A parancsmag például Move-Item áthelyez egy elemet az adattár egyik helyéről egy másik helyre. |
Átvitel, név, áttelepítés |
Új (n) | Létrehoz egy erőforrást. (Az Set ige akkor is használható, ha olyan erőforrást hoz létre, amely adatokat tartalmaz, például a Set-Variable parancsmagot.) |
Létrehozás, létrehozás, létrehozás, létrehozás, létrehozás, lefoglalás |
Megnyitás (op) | Módosítja az erőforrás állapotát, hogy elérhetővé, elérhetővé vagy használható legyen. Ez az ige és a párja Close . |
|
Optimalizálás (om) | Növeli az erőforrás hatékonyságát. | |
Pop (pop) | Eltávolít egy elemet a verem tetejéről. A parancsmag például Pop-Location a verembe legutóbb lekért helyre módosítja az aktuális helyet. |
|
Leküldés (pu) | Hozzáad egy elemet a verem tetejéhez. A parancsmag például Push-Location az aktuális helyet a verembe nyomja le. |
|
Újra ( újra) | Visszaállít egy erőforrást a visszavont állapotba. | |
Eltávolítás (r) | Töröl egy erőforrást egy tárolóból. A parancsmag például töröl Remove-Variable egy változót és annak értékét. Ez az ige és a párja Add . |
Clear, Cut, Dispose, Discard, Erase |
Átnevezés (rn) | Módosítja az erőforrás nevét. A tárolt adatok Rename-Item eléréséhez használt parancsmag például módosítja az adattár egy elemének nevét. |
Módosítás |
Alaphelyzetbe állítás (rs) | Visszaállítja az erőforrás eredeti állapotát. | |
Resize(rz) | Módosítja az erőforrás méretét. | |
Keresés (sr) | Létrehoz egy hivatkozást egy tárolóban található erőforrásra. | Keresés, Keresés |
Select (sc) (Kijelölés (sc) | Megkeres egy erőforrást egy tárolóban. A parancsmag például Select-String sztringekban és fájlokban keres szöveget. |
Keresés, Keresés |
Készlet (s) | Lecseréli egy meglévő erőforrás adatait, vagy létrehoz egy adatokat tartalmazó erőforrást. A parancsmag például Set-Date módosítja a rendszeridőt a helyi számítógépen. (A New művelet erőforrás létrehozására is használható.) Ez az ige és a párja Get . |
Írás, alaphelyzetbe állítás, hozzárendelés, konfigurálás |
Show (sh) | Láthatóvá tesz egy erőforrást a felhasználó számára. Ez az ige és a párja Hide . |
Megjelenítés, Termelés |
Kihagyás (sk) | Megkerül egy vagy több erőforrást vagy pontot egy sorozatban. | Mellőzés, ugrás |
Felosztás (sl) | Elkülöníti az erőforrás részeit. A parancsmag például Split-Path egy útvonal különböző részeit adja vissza. Ez az ige és a párja Join . |
Külön |
Lépés (st) | A következő pontra vagy erőforrásra kerül egy sorozatban. | |
Kapcsoló (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 állam közötti váltáshoz. | |
Visszavonás (visszavonás) | Beállítja az erőforrás előző állapotát. | |
Unlock (uk) | Felszabadít egy zárolt erőforrást. Ez az ige és a párja Lock . |
Kiadás, Korlátlan, Nem biztonságos |
Megtekintés (wc) | Az erőforrások folyamatos monitorozza és ellenőrzi a változásokat. |
Kommunikációs műveletek
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 műveletet felsorolja.
Művelet (alias) | Művelet | Kerülendő szinonimák |
---|---|---|
Csatlakozás (cc) | Kapcsolatot hoz létre egy forrás és egy cél között. Ez az ige és a párja Disconnect . |
Join, Telnet |
Kapcsolat bontása (dc) | Megszakítja a forrás és a cél közötti kapcsolatot. Ez az ige és a párja Connect . |
Break, Logoff |
Olvasás (rd) | Információkat szerez be egy forrásból. Ez az ige és a párja Write . |
Acquire, Prompt, Get |
Fogadás (rc) | Fogadja a forrásból küldött információkat. Ez az ige és a párja Send . |
Olvasás, Elfogadás, Betekintés |
Küldés (sd) | Adatokat kézbesít egy célhelyre. Ez az ige és a párja Receive . |
Put, Broadcast, Mail, Fax |
Írás (wr) | Információkat ad hozzá a célhoz. Ez az ige és a párja Read . |
Put, Print |
Adatigék
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 műveletet felsorolja.
Művelet neve (alias) | Művelet | Kerülendő szinonimák |
---|---|---|
Biztonsági mentés (ba) | Az adatokat replikálva tárolja. | Mentés, írás, replikálás, szinkronizálás |
Ellenőrzőpont (ch) | Pillanatképet készít az adatok vagy konfigurációja aktuális állapotáról. | Diff |
Összehasonlítás (cr) | Kiértékeli az egyik erőforrás adatait egy másik erőforrás adatai alapján. | Diff |
Tömörítés (cm) | Tömöríti egy erőforrás adatait. A és a Expand párok. |
Kompakt |
Convert (cv) | Módosítja az adatokat egyik megjelenítésről a másikra, 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. | Módosítás, átméretezés, újraminta |
ConvertFrom (cf) | Egy elsődleges bemeneti típust alakít át (a parancsmag főnév a bemenetet jelzi) egy vagy több támogatott kimeneti típusra. | Exportálás, Kimenet, Kimenő |
ConvertTo (ct) | Egy vagy több bemeneti típusról egy elsődleges kimeneti típusra konvertál (a parancsmag főnév a kimeneti típust jelöli). | Importálás, Bemenet, Be |
Leválasztás (dm) | Leválaszt egy elnevezett entitást egy helyről. Ez az ige és a párja Mount . |
Leválasztás, leválasztás |
Szerkesztés (szerkesztve ) | Tartalmak hozzáadásával vagy eltávolításával módosítja a meglévő adatokat. | Módosítás, frissítés, módosítás |
Kibontás (en) | Visszaállítja az eredeti állapotába tömörített erőforrás adatait. Ez az ige és a párja Compress . |
Eszkedő,presszetlen |
Exportálás (ep) | Az elsődleges bemenetet egy állandó adattárba, például fájlba vagy egy adatcsere-formátumba beágyazza. Ez az ige és a párja Import . |
Kinyerás, biztonsági mentés |
Csoport (gp) | Egy vagy több erőforrást rendez vagy társít | |
Importálás (ip) | Létrehoz egy erőforrást egy állandó adattárban (például fájlban) vagy felcserélhető formátumban tárolt adatokból. A parancsmag Import-CSV például vesszővel elválasztott értékfájlból importál adatokat más parancsmagok által használható objektumokba. Ez az ige és a párja Export . |
BulkLoad, Load |
Inicializálás (in) | Előkészít egy erőforrást a használatra, és beállítja az alapértelmezett állapotba. | Törlés, inicializálás, megújítás, újraépítés, újra inicializálás, beállítás |
Korlát (l) | Korlátozásokat alkalmaz egy erőforrásra. | Kvóta |
Egyesítés (mg) | Egyetlen erőforrást hoz létre több erőforrásból. | Összevonás, összekapcsolás |
Csatlakoztatás (mt) | Elnevezett entitást csatol egy helyhez. Ez az ige és a párja Dismount . |
Kapcsolódás |
Out (o) | Adatokat küld a környezetből. A parancsmag például Out-Printer adatokat küld egy nyomtatónak. |
|
Közzététel (pb) | Elérhetővé tesz egy erőforrást mások számára. Ez az ige és a párja Unpublish . |
Üzembe helyezés, kiadás, telepítés |
Visszaállítás (rr) | Előre meghatározott állapotba állít be egy erőforrást, például egy által beállított állapotra Checkpoint . A parancsmag például Restore-Computer elindít egy rendszer-visszaállítást a helyi számítógépen. |
Javítás, visszatérés, visszavonás, javítás |
Mentés (sv) | Az adatvesztés elkerülése érdekében megőrzi az adatokat. | |
Szinkronizálás (sy) | Biztosítja, hogy két vagy több erőforrás ugyanabban az állapotban van. | Replikálás, coerce, match |
Közzététel visszavonására (ub) | Elérhetetlenné tesz egy erőforrást mások számára. Ez az ige és a párja Publish . |
Eltávolítás, visszaállítás, elrejtés |
Frissítés (ud) | Naprakész állapotba hoz egy erőforrást, hogy fenntartsa az állapotát, pontosságát, megfelelőségét vagy megfelelőségét. A parancsmag például frissül Update-FormatData , és formázási fájlokat ad hozzá az aktuális PowerShell-konzolhoz. |
Frissítés, megújítás, újraszámítás, újraindexelés |
Diagnosztikai műveletek
A PowerShell a System.Management.Automation.VerbsDiagnostic osztály használatával határozza meg a diagnosztikára vonatkozó műveleteket. Az alábbi táblázat a legtöbb definiált műveletet felsorolja.
Művelet (alias) | Művelet | Kerülendő szinonimák |
---|---|---|
Hibakeresés (db) | Megvizsgál egy erőforrást a működési problémák diagnosztizálásához. | Diagnosztizálni |
Mérték (ms) | Azonosítja a megadott művelet által felhasznált erőforrásokat, vagy lekéri egy erőforrás statisztikáit. | Számítás, megállapításához, elemzéséhez |
Pingelés (pi) | Elavult – Használja helyette a Tesztelési igét. | |
Javítás (rp) | Visszaállít egy erőforrást egy használható feltételre | Javítás, visszaállítás |
Feloldás (rv) | Térképek egy erőforrás rövid ábrázolása teljesebb megjelenítésre. | Kibontás, megállapításához |
Teszt (t) | Ellenőrzi az erőforrás működését vagy konzisztenciáját. | Diagnosztizálás, elemzés, salvage, ellenőrzés |
Nyomkövetés (tr) | Nyomon követi egy erőforrás tevékenységeit. | Nyomon követés, követés, vizsgálat, dig |
Életciklus-műveletek
A PowerShell a System.Management.Automation.VerbsLifeCycle osztály használatával határozza meg az erőforrás életciklusára vonatkozó műveleteket. Az alábbi táblázat a legtöbb definiált műveletet felsorolja.
Művelet (alias) | Művelet | Kerülendő szinonimák |
---|---|---|
Jóváhagyás (ap) | Megerősíti vagy elfogadja egy erőforrás vagy folyamat állapotát. | |
Helyességi feltétel (as) | Megerősíti az erőforrás állapotát. | Certify |
Build (bd) | Létrehoz egy összetevőt (általában binárist vagy dokumentumot) néhány bemeneti fájlból (általában forráskódból vagy deklaratív dokumentumokból). Ez a parancs a PowerShell 6-ban lett hozzáadva. | |
Complete (cp) | Befejez egy műveletet. | |
Megerősítés (cn) | Nyugtázza, ellenőrzi vagy ellenőrzi egy erőforrás vagy folyamat állapotát. | Nyugtázás, megegyezés, minősítés, ellenőrzés |
Megtagadás (dn) | Elutasít, objektumokat, blokkokat vagy ellenzi egy erőforrás vagy folyamat állapotát. | Blokkolás, objektum, elutasítás, elutasítás |
Üzembe helyezés (dp) | Olyan módon küld egy alkalmazást, webhelyet vagy megoldást egy távoli célnak, hogy a megoldás fogyasztója az üzembe helyezés befejezése után hozzá tud férni. Ez a parancs a PowerShell 6-ban lett hozzáadva. | |
Letiltás (d) | Nem elérhető vagy inaktív állapotba konfigurál egy erőforrást. A parancsmag például Disable-PSBreakpoint inaktívvá teszi a töréspontot. Ez az ige párban áll a sal Enable . |
Leállítás, elrejtés |
Engedélyezés (e) | Elérhető vagy aktív állapotba konfigurál egy erőforrást. A parancsmag például Enable-PSBreakpoint aktívvá tesz egy töréspontot. Ez az ige párban áll a sal Disable . |
Indítás, Kezdés |
Telepítés (is) | Elhelyez egy erőforrást egy helyen, és igény szerint inicializálja azt. Ez az ige párban áll a sal Uninstall . |
Telepítés |
Meghívás (i) | Végrehajt egy műveletet, például parancsot vagy metódust futtat. | Futtatás, Indítás |
Regisztrálás (rg) | Létrehoz egy bejegyzést egy erőforráshoz egy adattárban, például egy adatbázisban. Ez az ige párban áll a sal Unregister . |
|
Kérés (rq) | Erőforrást kér, vagy engedélyeket kér. | |
Újraindítás (rt) | Leállít egy műveletet, majd újra elindítja. A parancsmag például leáll Restart-Service , majd elindít egy szolgáltatást. |
Újra |
Folytatás (ru) | Elindít egy felfüggesztett műveletet. A parancsmag például Resume-Service elindít egy felfüggesztett szolgáltatást. Ez az ige párban áll a sal Suspend . |
|
Indítás (sa) | Művelet kezdeményezése. A parancsmag például Start-Service elindít egy szolgáltatást. Ez az ige párban áll a sal Stop . |
Indítás, kezdeményezés, rendszerindítás |
Leállítás (sp) | Megszüntet egy tevékenységet. Ez az ige párban áll a sal Start . |
End, Kill, Terminate, Cancel |
Küldés (sb) | Egy jóváhagyásra vonatkozó erőforrást ad meg. | Közzététel |
Felfüggesztés (ss) | Szüneteltet egy tevékenységet. A parancsmag például Suspend-Service szüneteltet egy szolgáltatást. Ez az ige párban áll a sal Resume . |
Szünet |
Eltávolítás (us) | Eltávolít egy erőforrást egy jelzett helyről. Ez az ige párban áll a sal Install . |
|
Regisztrációjának ( saját) | Eltávolítja egy erőforrás bejegyzését egy adattárból. Ez az ige párban áll a sal Register . |
Eltávolítás |
Várakozás (w) | Felfüggeszt egy műveletet, amíg egy adott esemény be nem következik. A parancsmag például felfüggeszti Wait-Job a műveleteket, amíg egy vagy több háttér feladat be nem fejeződik. |
Alvó, szüneteltetés |
Biztonsági műveletek
A PowerShell a System.Management.Automation.VerbsSecurity osztály használatával határozza meg a biztonságra vonatkozó műveleteket. Az alábbi táblázat a legtöbb definiált műveletet felsorolja.
Művelet (alias) | Művelet | Kerülendő szinonimák |
---|---|---|
Blokk (bl) | Korlátozza az erőforrásokhoz való hozzáférést. Ez az ige párban áll a sal Unblock . |
Tiltás, korlátozás, tiltás |
Grant (gr) | Hozzáférést biztosít egy erőforráshoz. Ez az ige párban áll a sal Revoke . |
Engedélyezés, Engedélyezés |
Védelem (pt) | Védelmet nyújt egy erőforrásnak a támadással vagy veszteséggel szemben. Ez az ige párban áll a sal Unprotect . |
Titkosítás, védelem, lezárás |
Visszavonás (rk) | Olyan műveletet ad meg, amely nem engedélyezi az erőforrásokhoz való hozzáférést. Ez az ige párban áll a sal Grant . |
Eltávolítás, Letiltás |
Tiltás feloldása (ul) | Eltávolítja az erőforrásra vonatkozó korlátozásokat. Ez az ige párban áll a sal Block . |
Clear, Allow |
Védelem feloldása (felfelé) | Eltávolítja a hozzáadott erőforrások védelmi eszközét, hogy megakadályozza a támadásokat és az adatvesztést. Ez az ige párban áll a sal Protect . |
Visszafejtés, lefejtése |
Egyéb műveletek
A PowerShell a System.Management.Automation.VerbsOther osztály használatával határozza meg azokat a canonical verb neveket, amelyek nem illenek egy adott igésnév-kategóriába, például a közös, a kommunikáció, az adatok, az életciklus vagy a biztonsági műveletek neveibe.
Művelet (alias) | Művelet | Kerülendő szinonimák |
---|---|---|
Használat (u) | Egy erőforrást használ vagy foglal bele egy adott célra. |
Lásd még:
- System.Management.Automation.VerbsCommon
- System.Management.Automation.VerbsCommunications
- System.Management.Automation.VerbsData
- System.Management.Automation.VerbsDiagnostic
- System.Management.Automation.VerbsLifeCycle
- System.Management.Automation.VerbsSecurity
- System.Management.Automation.VerbsOther
- Parancsmag-deklaráció
- Windows PowerShell – programozói útmutató
- Windows PowerShell Shell SDK