Get-Verb

構文

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

説明

Get-Verb関数は、PowerShell コマンドでの使用が承認されている動詞を取得します。

PowerShell コマンドレットと関数名には、 Verb-Noun 形式を使用し、承認済みの動詞を含めうことをお勧めします。 この方法では、コマンド名の一貫性と予測性が高く、使いやすくなりました。

未承認の動詞を使用するコマンドは、引き続き PowerShell で実行されます。 ただし、名前に未承認の動詞を含むコマンドを含むモジュールをインポートすると、 Import-Module コマンドに警告メッセージが表示されます。

例

例 1 - すべての動詞の一覧を取得する

Get-Verb

例 2 - "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

例 3 - セキュリティ グループ内のすべての承認済み動詞を取得する

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

例 4 - 未承認の動詞を持つモジュール内のすべてのコマンドを検索する

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

パラメーター

-Group

-Verb

入力

None

このコマンドレットにオブジェクトをパイプすることはできません。

出力

VerbInfo

メモ

PowerShell 動詞は、最も一般的な用途に基づいてグループに割り当てられます。 グループは動詞の検索と比較を簡単にするように設計されています。使用を制限するためではありません。 あらゆる種類のコマンドにあらゆる承認された動詞を使用できます。

各 PowerShell 動詞は、次のいずれかのグループに割り当てられます。

• 共通: Add など、ほぼすべてのコマンドレットに適用できる汎用アクションを定義します。
• 通信: Connect などの通信に適用されるアクションを定義します。
• データ: バックアップなどのデータ処理に適用されるアクションを定義します。
• 診断: デバッグなどの診断に適用されるアクションを定義します。
• ライフサイクル: コマンドレットのライフサイクルに適用されるアクション (Complete など) を定義します。
• セキュリティ: 取り消しなど、セキュリティに適用されるアクションを定義します。
• その他: 他の種類のアクションを定義します。

Tee-ObjectやWhere-Objectなど、PowerShell と共にインストールされるコマンドレットの中には、未承認の動詞を使用するものもあります。 これらのコマンドレットは歴史的な例外であり、動詞は 予約済みとして分類されます。

関連リンク

• Import-Module