Sdílet prostřednictvím

Get-Verb

Modul:
Microsoft.PowerShell.Utility Module

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

Syntax

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 a funkcí PowerShellu měly formát Verb-Noun a obsahovaly schválený příkaz. 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 v Microsoft Docs.

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é znaky nejsou povoleny.

Tento parametr byl představen v PowerShellu 6.0.

Vlastnosti parametru

Typ:

String[]

Default value:All verbs
Podporuje zástupné znaky:False
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

-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 groups
Přípustné hodnoty:Common, Communications, Data, Diagnostic, Lifecycle, Other, Security
Podporuje zástupné znaky:True
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

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

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é.