英語で読む

次の方法で共有

Get-Verb

  • リファレンス
モジュール:
Microsoft.PowerShell.Core

承認済みの PowerShell 動詞を取得します。

構文

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

説明

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

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

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

注意

Get-Verb 返される動詞の一覧が完全でない可能性があります。 説明付きの承認済み PowerShell 動詞の更新された一覧については、「承認済み動詞の 」を参照してください。

例

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

PowerShell 
Get-Verb

例 2 - "un" で始まる承認済み動詞の一覧を取得する

PowerShell 
Get-Verb un*

Verb                 Group
----                 -----
Undo                 Common
Unlock               Common
Unpublish            Data
Uninstall            Lifecycle
Unregister           Lifecycle
Unblock              Security
Unprotect            Security

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

PowerShell 
Get-Verb | Where-Object Group -EQ Security

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

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

PowerShell 
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

パラメーター

-Verb

指定した動詞のみを取得します。 動詞または名前パターンの名前を入力します。 ワイルドカードを使用できます。

型:String[]
配置:1
規定値:All verbs
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:True

入力

None

出力

Selected.Microsoft.PowerShell.Commands.MemberDefinition

メモ

Get-Verb は、Microsoft.PowerShell.Commands.MemberDefinition オブジェクトの変更されたバージョンを返します。 このオブジェクトには、MemberDefinition オブジェクトの標準プロパティがありません。 代わりに、動詞 プロパティとグループ プロパティ。 Verb プロパティには、動詞名を持つ文字列が含まれています。 Group プロパティには、動詞グループを含む文字列が含まれています。

PowerShell 動詞は、最も一般的な用途に基づいてグループに割り当てられます。 グループは、動詞の使用を制限せず、動詞を簡単に見つけて比較できるように設計されています。 任意の種類のコマンドに対して任意の承認済み動詞を使用できます。

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

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

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