PowerShell コマンドに承認されている動詞

  • [アーティクル]

PowerShell の場合、コマンドレットの名前を表すため、および派生 .NET クラスを表すために、動詞-名詞のペアを使用します。 名前の動詞の部分は、コマンドレットで実行されるアクションを識別します。 名前の名詞の部分は、アクションが実行される対象であるエンティティを識別します。 たとえば、Get-Command は、PowerShell に登録されているすべてのコマンドを取得するコマンドレットです。

注意

PowerShell の場合、"動詞" という用語は、アクションを意味する単語 (その単語が英語の標準的な動詞でない場合でも) を記述するために使用されます。 たとえば、New という用語は英語の動詞ではありませんが、アクションを意味しているため、有効な PowerShell 動詞の名前です。

承認された各動詞には、対応する "エイリアスのプレフィックス" が定義されています。 このエイリアスのプレフィックスは、その動詞を使用するコマンドのエイリアスで使用します。 たとえば、Import のエイリアスのプレフィックスは ip であり、したがって Import-Module のエイリアスは ipmo です。 これは推奨事項ですが、規則ではありません。特に、他の環境の既知のコマンドを模倣しているコマンド エイリアスの場合は、従う必要はありません。

動詞の名前付けに関する推奨事項

次の推奨事項は、ご自身が作成するコマンドレットと PowerShell に用意されているコマンドレット、さらに他のユーザーが設計したコマンドレットとの間の一貫性を確保するために、ご自身のコマンドレット用に適切な動詞を選択する場合に役立ちます。

  • PowerShell に用意されている定義済み動詞名のいずれかを使用します。
  • 動詞を使用してアクションの全般的なスコープを記述し、パラメーターを使用してコマンドレットのアクションをさらに絞り込むことができます。
  • 承認された動詞のシノニムは使用しないでください。 たとえば、常に Remove を使用し、Delete や Eliminate は使用しません。
  • このトピックに記載されている各動詞の形式のみを使用します。 たとえば、Get は使用しますが、Getting または Gets は使用しません。
  • 次の予約された動詞またはエイリアスは使用しないでください。 PowerShell 言語とまれなコマンドレットでは、例外的な状況でこれらの動詞を使用します。
    • ForEach (foreach)
    • Ping (pi)
    • Sort (sr)
    • Tee (te)
    • Where (wh)

Get-Verb コマンドレットを使用して、動詞の完全な一覧を取得できます。

異なるアクションを表す類似した動詞

以下の類似した動詞は、異なるアクションを表します。

新規および追加

New は、新しいリソースを作成するときに使用します。 既存のコンテナーまたはリソースに何かを追加するには、 Add を使用します。 たとえば、は、 Add-Content 既存のファイルに出力を追加します。

New と オン

New は、新しいリソースを作成するときに使用します。 Set 動詞は、既存のリソースを変更するときに使用します。必要に応じて、Set-Variable コマンドレットのように、既存のものがない場合には作成します。

Find 動詞は、オブジェクトを検索するときに使用します。 Search 動詞は、コンテナー内のリソースへの参照を作成するときに使用します。

Get と Read

Get 動詞は、リソース (ファイルなど) に関する情報を取得するとき、または、リソースへの今後のアクセスに使用できるオブジェクトを取得するときに使用します。 Read動詞を使用してリソースを開き、内に含まれる情報を抽出します。

Invoke と [開始]

Invoke 動詞は、同期操作を実行するときに使用します。コマンドを実行し、その終了を待機する場合などです。 Start動詞を使用して、独立したプロセスの開始などの非同期操作を開始します。

Ping と テスト

Test 動詞を使用してください。

Common (共通) 動詞

PowerShell には、ほぼすべてのコマンドレットに適用できる汎用アクションが、System.Management.Automation.VerbsCommon 列挙クラスを使用して定義されています。 次の表は、ほとんどの定義済み動詞を示しています。

動詞 (エイリアス) アクション 避けるべきシノニム
Add (a) コンテナーにリソースを追加するか、項目を別の項目に付加します。 たとえば、Add-Content は、ファイルにコンテンツを追加するコマンドレットです。 この動詞は Remove と対になっています。 Append、Attach、Concatenate、Insert
Clear (cl) コンテナーからオブジェクトをすべて削除しますが、コンテナーは削除しません。 たとえば、Clear-Content コマンドレットによって、ファイルの内容は削除されますが、ファイルは削除されません。 Flush、Erase、Release、Unmark、Unset、Nullify
Close (cs) リソースの状態を変更して、アクセス不可または無効にするか、使用できないようにします。 この動詞は Open. と対になっています。
Copy (cp) リソースを別の名前または別のコンテナーにコピーします。 たとえば、Copy-Item は、データ ストア内のある場所から別の場所に項目 (ファイルなど) をコピーするコマンドレットです。 Duplicate、Clone、Replicate、Sync
Enter (et) ユーザーにリソース内への移動を許可するアクションを指定します。 たとえば、Enter-PSSession コマンドレットによって、ユーザーは対話型セッションに移行します。 この動詞は Exit と対になっています。 Push、Into
Exit (ex) 現在の環境またはコンテキストを、最後に使用したコンテキストに設定します。 たとえば、Exit-PSSession コマンドレットによって、ユーザーは対話型セッションを開始するために使用されたセッションに移行します。 この動詞は Enter と対になっています。 Pop、Out
Find (fd) 不明、暗黙、オプション、または指定のコンテナー内のオブジェクトを検索します。 検索
形式 (f) 指定されたフォームまたはレイアウトでオブジェクトを整列します
Get (g) リソースを取得するアクションを指定します。 この動詞は Set と対になっています。 Read、Open、Cat、Type、Dir、Obtain、Dump、Acquire、Examine、Find、Search
Hide (h) リソースを検出できないようにします。 たとえば、名前に Hide 動詞が含まれているコマンドレットを使用すると、ユーザーからサービスを隠すことができます。 この動詞は Show と対になっています。 ブロックする
Join (j) リソースを 1 つのリソースに結合します。 たとえば、Join-Path は、パスとその子パスの 1 つを組み合わせて 1 つのパスを作成するコマンドレットです。 この動詞は Split と対になっています。 Combine、Unite、Connect、Associate
Lock (lk) リソースをセキュリティで保護します。 この動詞は Unlock と対になっています。 Restrict、Secure
Move (m) ある場所から別の場所にリソースを移動します。 たとえば、Move-Item は、データ ストア内のある場所から別の場所に項目を移動するコマンドレットです。 Transfer、Name、Migrate
New (n) リソースを作成します。 (Set 動詞は、Set-Variable コマンドレットのように、データを含むリソースを作成するときにも使用できます。) Create、Generate、Build、Make、Allocate
Open (op) リソースの状態を変更して、アクセス可能または有効にするか、使用できるようにします。 この動詞は Close と対になっています。
Optimize (om) リソースの有効性を高めます。
Pop (pop) スタックの一番上から項目を削除します。 たとえば、Pop-Location は、現在の場所を、最後にスタックにプッシュされた場所に変更するコマンドレットです。
Push (pu) スタックの一番上に項目を追加します。 たとえば、Push-Location は、現在の場所をスタックにプッシュするコマンドレットです。
Redo (re) 元に戻した状態にリソースを再設定します。
Remove (r) コンテナーからリソースを削除します。 たとえば、Remove-Variable は、変数とその値を削除するコマンドレットです。 この動詞は Add と対になっています。 Clear、Cut、Dispose、Discard、Erase
Rename (rn) リソースの名前を変更します。 たとえば、格納されたデータにアクセスするために使用される Rename-Item は、データ ストア内の項目の名前を変更するコマンドレットです。 Change
Reset (rs) リソースを元の状態に設定し直します。
Resize(rz) リソースのサイズを変更します。
Search (sr) コンテナー内のリソースへの参照を作成します。 Find、Locate
Select (sc) コンテナー内のリソースを検索します。 たとえば、Select-String は、文字列およびファイル内のテキストを検索するコマンドレットです。 Find、Locate
Set (s) 既存のリソースのデータを置き換えるか、何らかのデータを含むリソースを作成します。 たとえば、Set-Date は、ローカル コンピューターのシステム時刻を変更するコマンドレットです (リソースを作成するには、New 動詞を使用することもできます)。この動詞は Get と対になっています。 Write、Reset、Assign、Configure
Show (sh) リソースをユーザーに表示します。 この動詞は Hide と対になっています。 Display、Produce
Skip (sk) シーケンス内の 1 つ以上のリソースまたはポイントをバイパスします。 Bypass、Jump
Split (sl) リソースの一部を分離します。 たとえば、Split-Path は、パスのさまざまな部分を返すコマンドレットです。 この動詞は Join と対になっています。 分離
Step (st) シーケンス内の次のポイントまたはリソースに移動します。
Switch (sw) 2 つの場所、責任、または状態の間での変更など、2 つのリソースを交互に切り替えるアクションを指定します。
Undo (un) リソースを以前の状態に設定します。
Unlock (uk) ロックされたリソースを解放します。 この動詞は Lock と対になっています。 Release、Unrestrict、Unsecure
Watch (wc) リソースの変更の有無を継続的に検査または監視します。

Communications (通信) 動詞

PowerShell には、通信に適用されるアクションが、System.Management.Automation.VerbsCommunications クラスを使用して定義されています。 次の表は、ほとんどの定義済み動詞を示しています。

動詞 (エイリアス) アクション 避けるべきシノニム
Connect (cc) ソースと宛先の間にリンクを作成します。 この動詞は Disconnect と対になっています。 Join、Telnet
Disconnect (dc) ソースと宛先の間のリンクを解除します。 この動詞は Connect と対になっています。 Break、Logoff
Read (rd) ソースから情報を取得します。 この動詞は Write と対になっています。 Acquire、Prompt、Get
Receive (rc) ソースから送信された情報を受け入れます。 この動詞は Send と対になっています。 Read、Accept、Peek
Send (sd) 宛先に情報を配信します。 この動詞は Receive と対になっています。 Put、Broadcast、Mail、Fax
Write (wr) ターゲットに情報を追加します。 この動詞は Read と対になっています。 Put、Print

Data (データ) 動詞

PowerShell には、データ処理に適用されるアクションが、System.Management.Automation.VerbsData クラスを使用して定義されています。 次の表は、ほとんどの定義済み動詞を示しています。

動詞名 (エイリアス) アクション 避けるべきシノニム
Backup (ba) データをレプリケートして格納します。 Save、Burn、Replicate、Sync
Checkpoint (ch) データの現在の状態またはその構成のスナップショットを作成します。 [Diff]
Compare (cr) あるリソースのデータを、別のリソースのデータと比較して評価します。 [Diff]
Compress (cm) リソースのデータを圧縮します。 Expand と対になっています。 コンパクト
Convert (cv) コマンドレットで双方向変換がサポートされている場合、またはコマンドレットで複数のデータ型間の変換がサポートされている場合、データの表現をあるものから別のものに変更します。 Change、Resize、Resample
ConvertFrom (cf) 1 種類のプライマリ入力 (コマンドレットの名詞が入力を示します) を、1 つ以上のサポートされている出力の種類に変換します。 Export、Output、Out
ConvertTo (ct) 1 つ以上の入力の種類を 1 つのプライマリ出力の種類に変換します (コマンドレットの名詞が出力の種類を示します)。 Import、Input、In
Dismount (dm) 名前付きエンティティを場所からデタッチします。 この動詞は Mount と対になっています。 Unmount、Unlink
Edit (ed) コンテンツを追加または削除することによって既存のデータを変更します。 Change、Update、Modify
Expand (en) 圧縮されたリソースのデータを元の状態に復元します。 この動詞は Compress と対になっています。 Explode、Uncompress
Export (ep) プライマリ入力をファイルなどの永続的なデータ ストアまたはインターチェンジ形式にカプセル化します。 この動詞は Import と対になっています。 Extract、Backup
グループ (gp) 1 つ以上のリソースを配置または関連付ける
Import (ip) 永続的なデータ ストア (ファイルなど) に、またはインターチェンジ形式で格納されているデータから、リソースを作成します。 たとえば、Import-CSV は、コンマ区切り値 (CSV) ファイルから、他のコマンドレットで使用できるオブジェクトにデータをインポートするコマンドレットです。 この動詞は Export と対になっています。 BulkLoad、Load
Initialize (in) 使用するリソースを準備し、それを既定の状態に設定します。 Erase、Init、Renew、Rebuild、Reinitialize、Setup
Limit (l) リソースに制約を適用します。 Quota
Merge (mg) 複数のリソースから 1 つのリソースを作成します。 Combine、Join
Mount (mt) 名前付きエンティティを場所にアタッチします。 この動詞は Dismount と対になっています。 接続する
Out (o) 環境からデータを送信します。 たとえば、Out-Printer は、プリンターにデータを送信するコマンドレットです。
Publish (pb) リソースを他のユーザーが使用できるようにします。 この動詞は Unpublish と対になっています。 Deploy、Release、Install
Restore (rr) リソースを定義済みの状態 (Checkpoint によって設定された状態など) に設定します。 たとえば、Restore-Computer は、ローカル コンピューター上でシステムの復元を開始するコマンドレットです。 Repair、Return、Undo、Fix
Save (sv) 損失を避けるためにデータを保持します。
Sync (sy) 2 つ以上のリソースが同じ状態にあることを保証します。 Replicate、Coerce、Match
Unpublish (ub) リソースを他のユーザーが使用できないようにします。 この動詞は Publish と対になっています。 Uninstall、Revert、Hide
Update (ud) 状態、精度、準拠、またはコンプライアンスを維持するために、リソースを最新の状態にします。 たとえば、Update-FormatData は、フォーマット ファイルを更新して現在の PowerShell コンソールに追加するコマンドレットです。 Refresh、Renew、Recalculate、Re-index

Diagnostic (診断) 動詞

PowerShell には、診断に適用されるアクションが、System.Management.Automation.VerbsDiagnostic クラスを使用して定義されています。 次の表は、ほとんどの定義済み動詞を示しています。

動詞 (エイリアス) アクション 避けるべきシノニム
Debug (db) リソースを調べて、運用上の問題を診断します。 診断
Measure (ms) 指定された操作によって使用されたリソースを識別するか、リソースに関する統計情報を取得します。 Calculate、Determine、Analyze
Ping (pi) 非推奨 - 代わりにテスト動詞を使用してください。
Repair (rp) リソースを使用できる状態に復元します。 Fix、Restore
Resolve (rv) リソースの簡略表現をより完全な表現にマップします。 Expand、Determine
Test (t) リソースの操作または整合性を検証します。 Diagnose、Analyze、Salvage、Verify
Trace (tr) リソースのアクティビティを追跡します。 Track、Follow、Inspect、Dig

Lifecycle (ライフサイクル) 動詞

PowerShell には、リソースのライフサイクルに適用されるアクションが、System.Management.Automation.VerbsLifeCycle クラスを使用して定義されています。 次の表は、ほとんどの定義済み動詞を示しています。

動詞 (エイリアス) アクション 避けるべきシノニム
Approve (ap) リソースまたはプロセスの状態を確認するか、それに同意します。
Assert (as) リソースの状態を表明します。 Certify
Build (bd) 何らかの入力ファイル セット (通常はソース コードまたは宣言ドキュメント) から成果物 (通常はバイナリまたはドキュメント) を作成します。この動詞は、PowerShell 6 で追加されました。
Complete (cp) 操作を終了します。
Confirm (cn) リソースまたはプロセスの状態を承認、検証、または確認します。 Acknowledge、Agree、Certify、Validate、Verify
Deny (dn) リソースまたはプロセスの状態を拒否、反対、ブロック、または禁止します。 Block、Object、Refuse、Reject
Deploy (dp) アプリケーション、Web サイト、またはソリューションをリモート ターゲットに送信して、そのソリューションのコンシューマーが展開の完了後にアクセスできるようにします。 この動詞は、PowerShell 6 で追加されました。
Disable (d) リソースを使用不可または非アクティブの状態に構成します。 たとえば、Disable-PSBreakpoint コマンドレットを使用すると、ブレークポイントが非アクティブになります。 この動詞は Enable と対になっています。 Halt、Hide
Enable (e) リソースを使用可能またはアクティブな状態に構成します。 たとえば、Enable-PSBreakpoint コマンドレットを使用すると、ブレークポイントがアクティブになります。 この動詞は Disable と対になっています。 Start、Begin
Install (is) リソースを場所に配置し、必要に応じて初期設定します。 この動詞は Uninstall と対になっています。 セットアップ
Invoke (i) コマンドやメソッドの実行などのアクションを実行します。 Run、Start
Register (rg) データベースなどのリポジトリにリソースのエントリを作成します。 この動詞は Unregister と対になっています。
Request (rq) リソースを要求するか、アクセス許可を要求します。
Restart (rt) 操作を停止し、再び開始します。 たとえば、Restart-Service は、サービスを停止してから開始するコマンドレットです。 リサイクル
Resume (ru) 中断されていた操作を開始します。 たとえば、Resume-Service は、中断されていたサービスを開始するコマンドレットです。 この動詞は Suspend と対になっています。
Start (sa) 操作を開始します。 たとえば、Start-Service はサービスを開始するコマンドレットです。 この動詞は Stop と対になっています。 Launch、Initiate、Boot
Stop (sp) アクティビティを中止します。 この動詞は Start と対になっています。 End、Kill、Terminate、Cancel
Submit (sb) 承認を受けるためにリソースを提示します。 投稿
Suspend (ss) アクティビティを一時停止します。 たとえば、Suspend-Service はサービスを一時停止するコマンドレットです。 この動詞は Resume と対になっています。 一時停止
Uninstall (us) 指示した場所からリソースを削除します。 この動詞は Install と対になっています。
Unregister (ur) リポジトリからリソースのエントリを削除します。 この動詞は Register と対になっています。 [削除]
Wait (w) 指定されたイベントが発生するまで、操作を一時停止します。 たとえば、Wait-Job は、1 つ以上のバックグラウンド ジョブが完了するまで操作を一時停止するコマンドレットです。 Sleep、Pause

Security (セキュリティ) 動詞

PowerShell には、セキュリティに適用されるアクションが、System.Management.Automation.VerbsSecurity クラスを使用して定義されています。 次の表は、ほとんどの定義済み動詞を示しています。

動詞 (エイリアス) アクション 避けるべきシノニム
Block (bl) リソースへのアクセスを制限します。 この動詞は Unblock と対になっています。 Prevent、Limit、Deny
Grant (gr) リソースへのアクセスを許可します。 この動詞は Revoke と対になっています。 Allow、Enable
Protect (pt) リソースを攻撃や損失から保護します。 この動詞は Unprotect と対になっています。 Encrypt、Safeguard、Seal
Revoke (rk) リソースへのアクセスを許可しないアクションを指定します。 この動詞は Grant と対になっています。 Remove、Disable
Unblock (ul) リソースに対する制限を削除します。 この動詞は Block と対になっています。 Clear、Allow
Unprotect (up) 攻撃や損失を防ぐために追加された保護をリソースから削除します。 この動詞は Protect と対になっています。 Decrypt、Unseal

Other (その他) 動詞

PowerShell には、共通、通信、データ、ライフサイクル、またはセキュリティ動詞名の動詞など、特定の動詞名カテゴリに当てはまらない正規動詞名が、System.Management.Automation.VerbsOther クラスを使用して定義されています。

動詞 (エイリアス) アクション 避けるべきシノニム
Use (u) リソースを使用または組み込んで何らかの処理を行います。

参照