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 są nadal uruchamiane w programie PowerShell. Jednak podczas importowania modułu zawierającego polecenie z niezatwierdzonym czasownikiem w nazwie Import-Module polecenie wyświetla komunikat ostrzegawczy.

Uwaga

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

Przykłady

Przykład 1 — pobieranie listy wszystkich czasowników

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 czasowników 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 z niezatwierdzonym czasownikami

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.

Type:String[]
Position:0
Default value:All verbs
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Verb

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

Type:String[]
Accepted values:Common, Communications, Data, Diagnostic, Lifecycle, Other, Security
Position:1
Default value:All groups
Required:False
Accept pipeline input:True
Accept wildcard characters:True

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żesz użyć dowolnego zatwierdzonego czasownika 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ń, takie jak odwoływanie.
  • Inne: Definiowanie innych typów 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ą wyjątkami historycznymi, a ich czasowniki są klasyfikowane jako zarezerwowane.