Get-Verb
Lekéri a jóváhagyott PowerShell-parancsokat.
Syntax
Get-Verb
[[-Verb] <String[]>]
[[-Group] <String[]>]
[<CommonParameters>]
Description
A Get-Verb
függvény lekéri a PowerShell-parancsokban való használatra jóváhagyott parancsokat.
Javasoljuk, hogy a PowerShell-parancsmagok és függvénynevek Verb-Noun
formátuma és egy jóváhagyott ige szerepeljen benne. Ez a gyakorlat konzisztensebbé, kiszámíthatóbbá és könnyebben használhatóvá teszi a parancsneveket.
A nem jóváhagyott igéket használó parancsok továbbra is a PowerShellben futnak. Ha azonban olyan modult importál, amely egy nem jóváhagyott igét tartalmazó parancsot tartalmaz a nevében, a Import-Module
parancs figyelmeztető üzenetet jelenít meg.
Feljegyzés
Előfordulhat, hogy a visszaadott Get-Verb
igék listája nem teljes. A jóváhagyott PowerShell-igék leírásokkal ellátott frissített listáját a Jóváhagyott igék című témakörben találja.
Példák
1. példa – Az összes igét tartalmazó lista lekérése
Get-Verb
2. példa – Az "un" kezdetű jóváhagyott igék listájának lekérése
Get-Verb un*
Verb AliasPrefix Group Description
---- ----------- ----- -----------
Undo un Common Sets a resource to its previous state
Unlock uk Common Releases a resource that was locked
Unpublish ub Data Makes a resource unavailable to others
Uninstall us Lifecycle Removes a resource from an indicated location
Unregister ur Lifecycle Removes the entry for a resource from a repository
Unblock ul Security Removes restrictions to a resource
Unprotect up Security Removes safeguards from a resource that were added to prevent it from attack or loss
3. példa – Az összes jóváhagyott parancs lekérése a Biztonsági csoportban
Get-Verb -Group Security
Verb AliasPrefix Group Description
---- ----------- ----- -----------
Block bl Security Restricts access to a resource
Grant gr Security Allows access to a resource
Protect pt Security Safeguards a resource from attack or loss
Revoke rk Security Specifies an action that does not allow access to a resource
Unblock ul Security Removes restrictions to a resource
Unprotect up Security Removes safeguards from a resource that were added to prevent it from attack or loss
4. példa – A nem jóváhagyott igékkel rendelkező modul összes parancsának keresése
Get-Command -Module Microsoft.PowerShell.Utility | Where-Object Verb -NotIn (Get-Verb).Verb
CommandType Name Version Source
----------- ---- ------- ------
Cmdlet Sort-Object 3.1.0.0 Microsoft.PowerShell.Utility
Cmdlet Tee-Object 3.1.0.0 Microsoft.PowerShell.Utility
Paraméterek
-Group
Csak a megadott csoportokat kapja meg. Adja meg egy csoport nevét. A helyettesítő karakterek nem engedélyezettek.
Ezt a paramétert a PowerShell 6.0-ban vezettük be.
Típus: | String[] |
Elfogadott értékek: | Common, Communications, Data, Diagnostic, Lifecycle, Other, Security |
Position: | 1 |
Alapértelmezett érték: | All groups |
Kötelező: | False |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | False |
-Verb
Csak a megadott igéket kapja meg. Adja meg egy ige vagy egy névminta nevét. Helyettesítő karakterek használata engedélyezett.
Típus: | String[] |
Position: | 0 |
Alapértelmezett érték: | All verbs |
Kötelező: | False |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | True |
Bevitelek
None
Ehhez a parancsmaghoz nem lehet objektumokat csövezni.
Kimenetek
Jegyzetek
A PowerShell-igék a leggyakoribb használatuk alapján vannak hozzárendelve egy csoporthoz. A csoportok úgy vannak kialakítva, hogy az igéket könnyen megtalálhassák és összehasonlíthassák, és ne korlátozzák a használatukat. Bármilyen parancstípushoz bármilyen jóváhagyott parancsot használhat.
Minden PowerShell-ige a következő csoportok egyikéhez van rendelve.
- Gyakori: Meghatározhat olyan általános műveleteket, amelyek szinte bármilyen parancsmagra alkalmazhatók, például a Hozzáadás parancsmagra.
- Kommunikáció: Definiálja a kommunikációra vonatkozó műveleteket, például a Connectet.
- Adatok: Az adatkezelésre vonatkozó műveletek, például a biztonsági mentés meghatározása.
- Diagnosztika: A diagnosztika, például hibakeresési műveletek definiálása.
- Életciklus: Definiálja a parancsmag életciklusára vonatkozó műveleteket, például a Complete parancsmagot.
- Biztonság: Határozza meg a biztonságra vonatkozó műveleteket, például a Visszavonást.
- Egyéb: Más típusú műveletek definiálása.
A PowerShell-lel telepített parancsmagok némelyike például Tee-Object
Where-Object
nem jóváhagyott parancsmagokat használ. Ezek a parancsmagok történelmi kivételek, és az igék fenntartottként vannak besorolva.