アクティビティのパラメーター
次の表に、アクティビティ パラメーターに推奨される名前と機能を示します。
| パラメーター | 機能 |
|---|---|
| Append データ型: SwitchParameter |
ユーザーがパラメーターを指定したときにリソースの末尾にコンテンツを追加できるように、このパラメーターを実装します。 |
| [CaseSensitive] データ型: SwitchParameter |
ユーザーがパラメーターを指定するときに大文字と小文字の区別を要求できるように、このパラメーターを実装します。 |
| Command データ型: String |
ユーザーが実行するコマンド文字列を指定できるように、このパラメーターを実装します。 |
| CompatibleVersion データ型: System.Version オブジェクト |
ユーザーが以前のバージョンとの互換性のためにコマンドレットと互換性がある必要があるセマンティクスを指定できるように、このパラメーターを実装します。 |
| Compress データ型: SwitchParameter |
パラメーターが指定されたときにデータ圧縮が使用されるように、このパラメーターを実装します。 |
| Compress データ型: Keyword |
ユーザーがデータ圧縮に使用するアルゴリズムを指定できるように、このパラメーターを実装します。 |
| Continuous データ型: SwitchParameter |
パラメーターが指定されたときにユーザーがコマンドレットを終了するまでデータが処理されるように、このパラメーターを実装します。 パラメーターが指定されていない場合、コマンドレットは定義済みの量のデータを処理し、操作を終了します。 |
| Create データ型: SwitchParameter |
このパラメーターを実装して、パラメーターの指定時にリソースがまだ存在しない場合にリソースが作成されることを示します。 |
| Delete データ型: SwitchParameter |
パラメーターが指定されたときにコマンドレットの操作が完了したときにリソースが削除されるように、このパラメーターを実装します。 |
| Drain データ型: SwitchParameter |
このパラメーターを実装して、パラメーターが指定されたときにコマンドレットが新しいデータを処理する前に未処理の作業項目が処理されることを示します。 パラメーターが指定されていない場合、作業項目はすぐに処理されます。 |
| Erase データ型: Int32 |
ユーザーが削除される前にリソースを消去する回数を指定できるように、このパラメーターを実装します。 |
| [ErrorLevel] データ型: Int32 |
ユーザーがレポートするエラーのレベルを指定できるように、このパラメーターを実装します。 |
| Exclude (除外) データ型: String[] |
ユーザーがアクティビティから何かを除外できるように、このパラメーターを実装します。 入力フィルターの使用方法の詳細については、「 入力フィルター パラメーター」を参照してください。 |
| Assert データ型: Keyword |
ユーザーがコマンドレット アクションを実行するリソースを選択するフィルターを指定できるように、このパラメーターを実装します。 入力フィルターの使用方法の詳細については、「 入力フィルター パラメーター」を参照してください。 |
| こちらに従ってください データ型: SwitchParameter |
パラメーターが指定されたときに進行状況が追跡されるように、このパラメーターを実装します。 |
| Force データ型: SwitchParameter |
このパラメーターを実装して、パラメーターが指定されたときに制限が発生した場合でも、ユーザーがアクションを実行できることを示します。 このパラメーターでは、セキュリティを侵害することはできません。 たとえば、このパラメーターを使用すると、ユーザーは読み取り専用ファイルを上書きできます。 |
| Include データ型: String[] |
ユーザーがアクティビティに何かを含めることができるように、このパラメーターを実装します。 入力フィルターの使用方法の詳細については、「 入力フィルター パラメーター」を参照してください。 |
| Incremental データ型: SwitchParameter |
このパラメーターを実装して、パラメーターが指定されたときに処理が増分実行されることを示します。 たとえば、このパラメーターを使用すると、ユーザーは前回のバックアップ以降にのみファイルをバックアップする増分バックアップを実行できます。 |
| 入力Object データ型: Object |
コマンドレットが他のコマンドレットから入力を受け取るときに、このパラメーターを実装します。 InputObject パラメーターを定義するときは、Parameter 属性を宣言するときに 常に ValueFromPipeline キーワードを指定します。 入力フィルターの使用方法の詳細については、「 入力フィルター パラメーター」を参照してください。 |
| Insert データ型: SwitchParameter |
パラメーターが指定されたときにコマンドレットによって項目が挿入されるように、このパラメーターを実装します。 |
| 対話 データ型: SwitchParameter |
パラメーターが指定されたときにコマンドレットがユーザーと対話形式で動作するように、このパラメーターを実装します。 |
| Interval データ型: HashTable |
ユーザーが値を含むキーワードのハッシュ テーブルを指定できるように、このパラメーターを実装します。 次の例は、パラメーター-interval @{ResumeScan=15; Retry=3}のサンプル値を Interval 示しています。 |
| Log データ型: SwitchParameter |
このパラメーターを実装すると、パラメーターが指定されたときにコマンドレットのアクションが監査されます。 |
| NoClobber データ型: SwitchParameter |
パラメーターが指定されたときにリソースが上書きされないように、このパラメーターを実装します。 通常、このパラメーターは、同じ名前の既存のオブジェクトを上書きできないように、新しいオブジェクトを作成するコマンドレットに適用されます。 |
| Notify データ型: SwitchParameter |
パラメーターが指定されたときにアクティビティが完了したことをユーザーに通知するように、このパラメーターを実装します。 |
| NotifyAddress データ型: 電子メール アドレス |
ユーザーがパラメーターを指定したときに通知を送信するために使用する電子メール アドレスを指定できるように、このパラメーターを Notify 実装します。 |
| Overwrite データ型: SwitchParameter |
パラメーターが指定されたときにコマンドレットによって既存のデータが上書きされるように、このパラメーターを実装します。 |
| Prompt データ型: String |
ユーザーがコマンドレットのプロンプトを指定できるように、このパラメーターを実装します。 |
| Quiet データ型: SwitchParameter |
このパラメーターを実装して、パラメーターが指定されたときに、コマンドレットがアクション中にユーザーのフィードバックを抑制できるようにします。 |
| Recurse データ型: SwitchParameter |
パラメーターが指定されたときにコマンドレットがリソースに対してアクションを再帰的に実行するように、このパラメーターを実装します。 |
| 修復 データ型: SwitchParameter |
このパラメーターを実装して、パラメーターが指定されたときに壊れた状態から何かを修正するようにします。 |
| 修理String データ型: String |
Repair パラメーターが指定されたときに使用する文字列をユーザーが指定できるように、このパラメーターを実装します。 |
| Retry データ型: Int32 |
ユーザーがコマンドレットでアクションを試行する回数を指定できるように、このパラメーターを実装します。 |
| Select データ型: Keyword array |
ユーザーが項目の種類を指定できるように、 array このパラメーターを実装します。 |
| Stream データ型: SwitchParameter |
パラメーターが指定されたときに、ユーザーがパイプラインを介して複数の出力オブジェクトをストリーミングできるように、このパラメーターを実装します。 |
| Strict データ型: SwitchParameter |
パラメーターが指定されたときに、すべてのエラーが終了エラーとして処理されるように、このパラメーターを実装します。 |
| TempLocation データ型: String |
ユーザーがコマンドレットの操作中に使用される一時データの場所を指定できるように、このパラメーターを実装します。 |
| タイムアウト データ型: Int32 |
ユーザーがタイムアウト間隔 (ミリ秒単位) を指定できるように、このパラメーターを実装します。 |
| Truncate データ型: SwitchParameter |
パラメーターが指定されたときにコマンドレットがアクションを切り捨てるように、このパラメーターを実装します。 パラメーターが指定されていない場合、コマンドレットは別のアクションを実行します。 |
| Verify データ型: SwitchParameter |
このパラメーターを実装して、パラメーターが指定されたときにアクションが発生したかどうかを判断するコマンドレットをテストします。 |
| Wait データ型: SwitchParameter |
このパラメーターを実装して、パラメーターが指定されたときにコマンドレットがユーザー入力を待機してから続行できるようにします。 |
| WaitTime データ型: Int32 |
Wait パラメーターが指定されたときにコマンドレットがユーザー入力を待機する期間 (秒単位) をユーザーが指定できるように、このパラメーターを実装します。 |
関連項目
フィードバック
フィードバックの送信と表示