Sdílet prostřednictvím


Get-Verb

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

Syntax

Default (Výchozí)

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

Description

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

PowerShell doporučuje, aby názvy rutin a funkcí měly formát Verb-Noun a obsahoval schválené sloveso. 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 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                 Group
----                 -----
Undo                 Common
Unlock               Common
Unpublish            Data
Uninstall            Lifecycle
Unregister           Lifecycle
Unblock              Security
Unprotect            Security

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

Get-Verb | Where-Object Group -EQ Security
Verb      Group
----      -----
Block     Security
Grant     Security
Protect   Security
Revoke    Security
Unblock   Security
Unprotect Security

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

-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:1
Povinné:False
Hodnota z kanálu:True
Hodnota z kanálu podle názvu vlastnosti:False
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

Selected.Microsoft.PowerShell.Commands.MemberDefinition

Poznámky

Get-Verb vrátí upravenou verzi objektu Microsoft.PowerShell.Commands.MemberDefinition. Objekt nemá standardní vlastnosti MemberDefinition objektu. Místo toho má vlastnosti příkaz a Group. Vlastnost Sloveso obsahuje řetězec s názvem příkazu. Vlastnost Group obsahuje řetězec se skupinou sloves.

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