Sdílet prostřednictvím

Get-Verb

  • Reference
Modul:
Microsoft.PowerShell.Utility

Získá schválené příkazy PowerShellu.

Syntaxe

Get-Verb
   [[-Verb] <String[]>]
   [[-Group] <String[]>]
   [<CommonParameters>]

Description

Funkce Get-Verb získá příkazy schválené pro použití v příkazech PowerShellu.

Doporučuje se, aby názvy rutin PowerShellu a funkcí měly Verb-Noun formát a obsahovaly schválené příkazy. Tento postup usnadňuje používání názvů příkazů konzistentněji, předvídatelně a snadněji.

Příkazy, které používají neschválené příkazy, se pořád spouštějí v PowerShellu. Když ale importujete modul, který obsahuje příkaz s neschváleném slovesem v názvu, Import-Module zobrazí se v příkazu zpráva s upozorněním.

Poznámka:

Seznam sloves, který vrací, Get-Verb nemusí být úplný. Aktualizovaný seznam schválených příkazů PowerShellu s popisy najdete v tématu Schválené příkazy.

Příklady

Příklad 1 – Získání seznamu všech sloves

Get-Verb

Příklad 2 – Získání seznamu schválených sloves, které začínají na "un"

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

Příklad 3 – Získání všech schválených příkazů ve skupině Zabezpečení

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

Příklad 4 – Najde všechny příkazy v modulu, který má neschválené příkazy.

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

Parametry

-Group

Získá pouze zadané skupiny. Zadejte název skupiny. Zástupné cardy nejsou povolené.

Tento parametr byl představen v PowerShellu 6.0.

Typ:String[]
Přípustné hodnoty:Common, Communications, Data, Diagnostic, Lifecycle, Other, Security
Position:1
Default value:All groups
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Verb

Získá pouze zadané příkazy. Zadejte název slovesa nebo vzoru názvu. Jsou povoleny zástupné cardy.

Typ:String[]
Position:0
Default value:All verbs
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:True

Vstupy

None

Do této rutiny nemůžete roušit objekty.

Výstupy

VerbInfo

Poznámky

Příkazy PowerShellu se přiřazují ke skupině na základě jejich nejběžnějšího použití. Skupiny jsou navrženy tak, aby se příkazy snadno našli a porovnávali, a neomezili jejich použití. Pro libovolný typ příkazu můžete použít libovolný schválený příkaz.

Každé sloveso PowerShellu je přiřazeno k jedné z následujících skupin.

  • Běžné: Definujte obecné akce, které se dají použít u téměř jakékoli rutiny, například Přidat.
  • Komunikace: Definujte akce, které se vztahují na komunikaci, například Připojit.
  • Data: Definujte akce, které se vztahují na zpracování dat, například zálohování.
  • Diagnostika: Definujte akce, které se vztahují na diagnostiku, například Ladění.
  • Životní cyklus: Definujte akce, které se vztahují na životní cyklus rutiny, například Dokončeno.
  • Zabezpečení: Definujte akce, které se vztahují na zabezpečení, například odvolání.
  • Jiné: Definujte další typy akcí.

Některé rutiny nainstalované pomocí PowerShellu, například Tee-Object a Where-Object, používají neschválené příkazy. Tyto rutiny jsou historické výjimky a jejich příkazy jsou klasifikovány jako rezervované.