Udostępnij za pośrednictwem

Get-Verb

  • Odwołanie
Moduł:
Microsoft.PowerShell.Utility

Pobiera zatwierdzone czasowniki programu PowerShell.

Składnia

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 Verb-Noun format 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 jego nazwie Import-Module polecenie wyświetla komunikat ostrzegawczy.

Uwaga

Lista czasowników zwracanych Get-Verb może nie zostać ukończona. Aby uzyskać zaktualizowaną listę zatwierdzonych czasowników programu PowerShell z opisami, zobacz Zatwierdzone zlecenia.

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.

Typ:String[]
Dopuszczalne wartości:Common, Communications, Data, Diagnostic, Lifecycle, Other, Security
Position:1
Domyślna wartość:All groups
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Verb

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

Typ:String[]
Position:0
Domyślna wartość:All verbs
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:True

Dane wejściowe

None

Nie można potokować obiektów do tego polecenia cmdlet.

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ą niezatwierdzonych czasowników. Te polecenia cmdlet są wyjątkami historycznymi, a ich czasowniki są klasyfikowane jako zarezerwowane.