ユーザ ステージ
5 min
ユーザ ステージを作成し、ボット作成で使用するステージをカスタマイズして保存します。 作成したステージは、ボット エディタの [ステージ] > [ユーザ] で再利用できます。
ユーザ ステージを作成するには
- [メインメニュー] > [ボット] に移動します。 [ボット] ホームページが表示されます。
- [汎用ボット] タブまたは [調査ボット] タブを選択します。
- [ボットの作成] または [調査を作成] を選択します。 [ボットの作成] または [調査を作成] ページが表示されます。
- ボット トリガ (スケジュールまたはカスタム アクション) を選択します。
- ターゲット タイプ ([デバイス] または [ユーザ]) を選択します。
- ボットの [名前] を入力します。 任意で、簡潔な説明を入力します。
- [作成] をクリックします。 Bots エディタのページが表示されます。 新しいボットは非アクティブな下書きバージョンとして保存されます。
- [新規ボット] エディタ ページで、[ユーザ ステージの管理] を選択して [ユーザ ステージ マネージャ] ページを表示します。
- [ユーザ ステージ マネージャ] ページで、[作成] ドロップダウンをクリックし、次の中から目的のステージを選択します。
- PowerShell クエリ
- PowerShell アクション
- Bash アクション
- コマンド アクション
- OSQuery
- [ユーザ ステージ エディタ] ページで、[ステージ名] を入力します。 例: ファイル/フォルダの圧縮
- 任意で、説明を入力します。 説明テキストは、ボット エディタ内と、[ステージ設定] パネルから [ステージ情報] が選択されたときに表示されます。 例: このステージでは、指定したパスのソース ファイルが、宛先パス内に、指定した圧縮レベルで圧縮されます。
- スクリプト コードを入力します。 例: Compress-Archive -path C:\logs\file.txt -destinationpath C:\logs\file.zip -compressionlevel Optimal
ハード コードの一部を変数に置き換えることで、このスクリプトをより柔軟にすることができます。 これにより、ステージを使用するときに要素をカスタマイズできるようになります。 例: Compress-Archive -path __Path to Source File or Folder__ -destinationpath __Destination Path__ -compressionlevel __Compression level|options:Fastest,Optimal,No Compression__
Ctrl + Space を選択して、[オプション変数] または [値変数] を挿入します。
- [オプション変数] は、設定内に選択ドロップダウンとして表示されます。使用可能なオプションは、スクリプトに入力したものになります。 この例の場合: 圧縮レベル オプションである Fastest、Optimal、No Compression。
- [値変数] は、設定内にテキスト ボックスとして、スクリプトに入力したラベルとともに表示されます。 この例の場合: ソース ファイルまたはソース フォルダへのパス、宛先パス、および圧縮レベル。
この例の場合、[ステージ設定] は次のようになります。

- [ステージ設定] を完了します。使用可能な設定は、作成しているユーザ ステージのタイプによって異なります。
- [適用して閉じる] を選択して、ユーザ ステージを保存します。 既存のユーザ ステージを編集した場合は、新規バージョンが作成されます。 保存時、このユーザ ステージを使用しているボットはすべて、最新バージョンを使用するように更新する必要がある旨、警告するダイアログが表示されます。
アクション
任意のユーザ ステージに対して次のアクションを実行できます。
- 複製: ユーザ ステージを選択し、[アクション] > [複製] を選択します。 [ステージを複製] ダイアログが表示されます。 一意の名前を入力し、[複製] を選択します。 ステージの作成が成功したことを知らせるポップアップ メッセージが表示されます。 複製されたステージがリストに表示され、選択して編集できるようになります。
- 削除: 1つ以上のユーザ ステージを選択し、[アクション] > [削除] を選択します。 [ステージを削除] ダイアログが表示されます。 [削除] を選択して、ステージの削除を確認します。 このアクションは元に戻すことができず、それを使用したボットからのステージは非推奨になります。 非推奨のステージは赤い枠線で示されます。
