Udostępnij za pośrednictwem

Get-Verb

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

Pobiera zatwierdzone czasowniki programu PowerShell.

Składnia

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

Opis

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

Program PowerShell zaleca, aby nazwy poleceń cmdlet i funkcji miały format czasownika Verb-Noun i zawierają 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 są uruchamiane 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                 Group
----                 -----
Undo                 Common
Unlock               Common
Unpublish            Data
Uninstall            Lifecycle
Unregister           Lifecycle
Unblock              Security
Unprotect            Security

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

Get-Verb | Where-Object Group -EQ Security

Verb      Group
----      -----
Block     Security
Grant     Security
Protect   Security
Revoke    Security
Unblock   Security
Unprotect Security

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

-Verb

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

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

Dane wejściowe

None

Dane wyjściowe

Selected.Microsoft.PowerShell.Commands.MemberDefinition

Uwagi

Get-Verb Zwraca zmodyfikowaną wersję obiektu Microsoft.PowerShell.Commands.MemberDefinition . Obiekt nie ma standardowych właściwości obiektu MemberDefinition . Zamiast tego ma właściwości Czasownik i Grupa . Właściwość Verb zawiera ciąg o nazwie czasownika. Właściwość Grupa zawiera ciąg z grupą czasowników.

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.