Get-Verb
承認済みの PowerShell 動詞を取得します。
構文
Get-Verb
[[-verb] <String[]>]
[<CommonParameters>]
説明
Get-Verb
関数は、PowerShell コマンドでの使用が承認されている動詞を取得します。
PowerShell では、コマンドレット名と関数名には動詞と名詞の形式を使用し、承認済みの動詞を含める必要があります。 この方法では、コマンド名の一貫性と予測性が高く、使いやすくなりました。
承認されていない動詞を使用するコマンドは、PowerShell で実行されます。 ただし、名前に未承認の動詞を含むコマンドを含むモジュールをインポートすると、 Import-Module
コマンドに警告メッセージが表示されます。
Note
Get-Verb
返される動詞リストが完全でない可能性があります。 説明付きの承認済み PowerShell 動詞の更新された一覧については、「 Approved Verbs」を参照してください。
例
例 1 - すべての動詞の一覧を取得する
Get-Verb
例 2 - "un" で始まる承認済み動詞の一覧を取得する
Get-Verb un*
Verb Group
---- -----
Undo Common
Unlock Common
Unpublish Data
Uninstall Lifecycle
Unregister Lifecycle
Unblock Security
Unprotect Security
例 3 - セキュリティ グループ内のすべての承認済み動詞を取得する
Get-Verb | Where-Object Group -EQ Security
Verb Group
---- -----
Block Security
Grant Security
Protect Security
Revoke Security
Unblock Security
Unprotect Security
例 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
パラメーター
-Verb
指定した動詞のみを取得します。 動詞の名前または名前パターンを入力します。 ワイルドカードを使用できます。
型: | String[] |
配置: | 1 |
規定値: | All verbs |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | True |
入力
None
出力
Selected.Microsoft.PowerShell.Commands.MemberDefinition
メモ
Get-Verb
は、 Microsoft.PowerShell.Commands.MemberDefinition オブジェクトの変更されたバージョンを返します。 オブジェクトには、 MemberDefinition オブジェクトの標準プロパティがありません。 代わりに、 Verb プロパティと Group プロパティがあります。 Verb プロパティには、動詞名を持つ文字列が含まれています。
Group プロパティには、動詞グループを含む文字列が含まれています。
PowerShell 動詞は、最も一般的な用途に基づいてグループに割り当てられます。 グループは動詞の検索と比較を簡単にするように設計されています。使用を制限するためではありません。 あらゆる種類のコマンドにあらゆる承認された動詞を使用できます。
各 PowerShell 動詞は、次のいずれかのグループに割り当てられます。
- 共通: Add など、ほぼすべてのコマンドレットに適用できる汎用アクションを定義します。
- 通信: Connect などの通信に適用されるアクションを定義します。
- データ: バックアップなどのデータ処理に適用されるアクションを定義します。
- 診断: デバッグなどの診断に適用されるアクションを定義します。
- ライフサイクル: コマンドレットのライフサイクルに適用されるアクション (Complete など) を定義します。
- セキュリティ: 取り消しなど、セキュリティに適用されるアクションを定義します。
- その他: 他の種類のアクションを定義します。
Tee-Object
やWhere-Object
など、PowerShell と共にインストールされるコマンドレットの中には、未承認の動詞を使用するものもあります。 これらのコマンドレットは歴史的な例外であり、動詞は 予約済みとして分類されます。
関連リンク
PowerShell