Get-Verb
Hämtar godkända PowerShell-verb.
Syntax
Get-Verb
[[-Verb] <String[]>]
[[-Group] <String[]>]
[<CommonParameters>]
Description
Funktionen Get-Verb
hämtar verb som är godkända för användning i PowerShell-kommandon.
Vi rekommenderar att PowerShell-cmdleten och funktionsnamnen har Verb-Noun
format och innehåller ett godkänt verb. Den här metoden gör kommandonamnen mer konsekventa, förutsägbara och enklare att använda.
Kommandon som använder icke godkända verb körs fortfarande i PowerShell. Men när du importerar en modul som innehåller ett kommando med ett verb som inte har godkänts i dess namn, visar kommandot Import-Module
ett varningsmeddelande.
Not
Verblistan som Get-Verb
returnerar kanske inte är fullständig. En uppdaterad lista över godkända PowerShell-verb med beskrivningar finns i godkända verb.
Exempel
Exempel 1 – Hämta en lista över alla verb
Get-Verb
Exempel 2 – Hämta en lista över godkända verb som börjar med "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
Exempel 3 – Hämta alla godkända verb i säkerhetsgruppen
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
Exempel 4 – Hittar alla kommandon i en modul som har icke godkända verb
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
Parametrar
-Group
Hämtar endast de angivna grupperna. Ange namnet på en grupp. Jokertecken tillåts inte.
Den här parametern introducerades i PowerShell 6.0.
Typ: | String[] |
Godkända värden: | Common, Communications, Data, Diagnostic, Lifecycle, Other, Security |
Position: | 1 |
Standardvärde: | All groups |
Obligatorisk: | False |
Godkänn pipeline-indata: | True |
Godkänn jokertecken: | False |
-Verb
Hämtar endast de angivna verben. Ange namnet på ett verb eller ett namnmönster. Jokertecken tillåts.
Typ: | String[] |
Position: | 0 |
Standardvärde: | All verbs |
Obligatorisk: | False |
Godkänn pipeline-indata: | True |
Godkänn jokertecken: | True |
Indata
None
Du kan inte skicka objekt till den här cmdleten.
Utdata
Kommentarer
PowerShell-verb tilldelas till en grupp baserat på deras vanligaste användning. Grupperna är utformade för att göra verben enkla att hitta och jämföra, inte för att begränsa användningen. Du kan använda alla godkända verb för alla typer av kommandon.
Varje PowerShell-verb tilldelas till någon av följande grupper.
- Vanligt: Definiera allmänna åtgärder som kan tillämpas på nästan alla cmdletar, till exempel Lägg till.
- Kommunikation: Definiera åtgärder som gäller för kommunikation, till exempel Anslut.
- Data: Definiera åtgärder som gäller för datahantering, till exempel säkerhetskopiering.
- Diagnostik: Definiera åtgärder som gäller för diagnostik, till exempel Felsökning.
- Livscykel: Definiera åtgärder som gäller för livscykeln för en cmdlet, till exempel Slutför.
- Säkerhet: Definiera åtgärder som gäller för säkerhet, till exempel Återkalla.
- Övrigt: Definiera andra typer av åtgärder.
Några av de cmdletar som installerats med PowerShell, till exempel Tee-Object
och Where-Object
, använder icke godkända verb. Dessa cmdletar är historiska undantag och deras verb klassificeras som reserverade.