Sdílet prostřednictvím

Get-Verb

Modul:
Microsoft.PowerShell.Utility Module

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

Syntaxe

Default (Výchozí) 

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 formát Verb-Noun 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, zobrazí příkaz Import-Module zprávu s upozorněním.

Poznámka:

Seznam sloves, který Get-Verb vrací, 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.

Vlastnosti parametru

Typ:

String[]

Default value:All groups
Přípustné hodnoty:Common, Communications, Data, Diagnostic, Lifecycle, Other, Security
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:1
Povinné:False
Hodnota z kanálu:True
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False

-Verb

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

Vlastnosti parametru

Typ:

String[]

Default value:All verbs
Podporuje zástupné znaky:True
DontShow:False

Sady parametrů

(All)
Position:0
Povinné:False
Hodnota z kanálu:True
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False

CommonParameters

Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.

Vstupy

None

Do tohoto cmdletu nemůžete předávat 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é.