Udostępnij przez

Get-Verb

Moduł:
Microsoft.PowerShell.Utility Module

Pobiera zatwierdzone czasowniki programu PowerShell.

Składnia

Default (domyślnie) 

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

Opis

Funkcja Get-Verb pobiera czasowniki zatwierdzone do użycia w poleceniach programu PowerShell.

Zaleca się, aby nazwy poleceń cmdlet i funkcji programu PowerShell miały format Verb-Noun i zawierały zatwierdzone zlecenie. Ta praktyka sprawia, że nazwy poleceń są bardziej spójne, przewidywalne i łatwiejsze w użyciu.

Polecenia korzystające z niezatwierdzonych czasowników nadal działają w programie PowerShell. Jednak podczas importowania modułu zawierającego polecenie z niezatwierdzonym czasownikiem w nazwie polecenie Import-Module wyświetla komunikat ostrzegawczy.

Nuta

Lista zleceń zwracająca Get-Verb może nie zostać ukończona. Aby uzyskać zaktualizowaną listę zatwierdzonych czasowników programu PowerShell z opisami, zobacz Zatwierdzone czasowniki w witrynie Microsoft Docs.

Przykłady

Przykład 1 — pobieranie listy wszystkich zleceń

Get-Verb

Przykład 2 — pobieranie listy zatwierdzonych czasowników rozpoczynających się od "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

Przykład 3 — pobieranie wszystkich zatwierdzonych zleceń w grupie zabezpieczeń

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

Przykład 4 — znajduje wszystkie polecenia w module, w których nietwierdzone czasowniki

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

Pobiera tylko określone grupy. Wprowadź nazwę grupy. Symbole wieloznaczne nie są dozwolone.

Ten parametr został wprowadzony w programie PowerShell 6.0.

Właściwości parametru

Typ:

String[]

Domyślna wartość:All verbs
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:0
Obowiązkowe:False
Wartość z potoku:True
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

-Verb

Pobiera tylko określone czasowniki. Wprowadź nazwę zlecenia lub wzorzec nazwy. Symbole wieloznaczne są dozwolone.

Właściwości parametru

Typ:

String[]

Domyślna wartość:All groups
Dopuszczalne wartości:Common, Communications, Data, Diagnostic, Lifecycle, Other, Security
Obsługuje symbole wieloznaczne:True
DontShow:False

Zestawy parametrów

(All)
Position:1
Obowiązkowe:False
Wartość z potoku:True
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

CommonParameters

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

Dane wejściowe

None

Dane wyjściowe

VerbInfo

Uwagi

Czasowniki programu PowerShell są przypisywane do grupy na podstawie ich najpopularniejszego użycia. Grupy zostały zaprojektowane tak, aby czasowniki można było łatwo znaleźć i porównać, a nie ograniczyć ich użycia. Można użyć dowolnego zatwierdzonego zlecenia dla dowolnego typu polecenia.

Każde zlecenie programu PowerShell jest przypisywane do jednej z następujących grup.

  • Typowe: Zdefiniuj akcje ogólne, które mogą być stosowane do niemal dowolnego polecenia cmdlet, takiego jak Dodaj.
  • Komunikacja: zdefiniuj akcje dotyczące komunikacji, takie jak Connect.
  • Dane: zdefiniuj akcje, które mają zastosowanie do obsługi danych, takich jak Kopia zapasowa.
  • Diagnostyka: zdefiniuj akcje, które mają zastosowanie do diagnostyki, takiej jak Debugowanie.
  • Cykl życia: zdefiniuj akcje, które mają zastosowanie do cyklu życia polecenia cmdlet, takiego jak Complete.
  • Zabezpieczenia: zdefiniuj akcje, które mają zastosowanie do zabezpieczeń, na przykład Odwołaj.
  • Inne: Zdefiniuj inne typy akcji.

Niektóre polecenia cmdlet zainstalowane za pomocą programu PowerShell, takie jak Tee-Object i Where-Object, używają nietwierdzonych zleceń. Te polecenia cmdlet są wyjątkami historycznymi, a ich czasowniki są klasyfikowane jako zarezerwowane.