Udostępnij przez


Get-Verb

Pobiera zatwierdzone czasowniki w PowerShellu.

Składnia

Default (Domyślna)

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

Uwaga / Notatka

Lista czasowników, którą zwraca Get-Verb, mogła nie być kompletna. Aby uzyskać zaktualizowaną listę zatwierdzonych czasowników programu PowerShell z opisami, zobacz zatwierdzone czasowniki.

Przykłady

Przykład 1 — uzyskanie listy wszystkich czasowników

Get-Verb

Przykład 2 — pobierz listę 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 czasowników 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, które mają niezatwierdzone 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ę czasownika lub wzorzec nazwy. Symbole wieloznaczne są dozwolone.

Właściwości parametru

Typ:

String[]

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

Zestawy parametrów

(All)
Position:1
Obowiązkowy:False
Wartość z potoku:True
Wartość z potoku według nazwy właściwości:False
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

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 czasownika do dowolnego typu polecenia.

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

  • Ogólne: Zdefiniuj ogólne działania, które mogą być stosowane do prawie każdego cmdletu, 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 w programie PowerShell, takie jak Tee-Object i Where-Object, używają niezatwierdzonych czasowników. Te polecenia cmdlet są historycznymi wyjątkami, a ich czasowniki klasyfikowane są jako zarezerwowane.