アクションの生成

ワークフローを実行して、
PowerShell
スクリプトまたは
PowerShell
コマンドレットに基づくアクションを生成できます。生成されたワークフローは、カスタム ワークフローのビルディング ブロックとして使用することができます。

PowerShell
スクリプトからのアクションの生成

ワークフローを実行して、指定した
PowerShell
スクリプトからアクションを生成できます。生成したアクションを実行するサンプル ワークフローを任意で作成することもできます。
  • 管理者として
    Automation Orchestrator
    クライアントにログインしていることを確認します。
  • インベントリ
    ビューから PowerShell ホストへの接続があることを確認します。
生成したアクションのスクリプトをプレースホルダを使用してカスタマイズできます。生成したアクションでは、ワークフローによって
string
タイプの対応するアクション パラメータがプレースホルダごとに作成されます。アクションを実行する際、実際の値をアクション パラメータに指定して、プレースホルダを置き換えることができます。
  1. Automation Orchestrator
    クライアントで
    ライブラリ
    ワークフロー
    の順に移動して、ワークフローの検索ボックスに
    powershell
    および
    generate
    タグを入力します。
  2. PowerShell スクリプトからのアクションの生成
    ワークフローを見つけて、
    実行
    をクリックします。
  3. スクリプト
    タブで
    スクリプト
    テキスト ボックスに、アクションを生成する
    PowerShell
    スクリプトを入力または貼り付けます。
    ユーザー入力のプレースホルダとして
    {#ParamName#}
    を使用できます。プレースホルダのタイプが
    string
    である場合、二重引用符を使用してプレースホルダの値をアクションに渡す必要があります。
    次のスクリプトは、生成したアクション パラメータをスクリプト パラメータにリンクする方法の例を示しています。
    param($name={#ParamName#}) echo $name;
  4. アクション
    タブの
    名前
    テキストボックスに、生成するアクションの名前を入力して、アクションを生成する既存のモジュールを選択します。
  5. ワークフロー
    タブで、ワークフローを生成するかどうかを選択します。
    オプション
    説明
    はい
    生成したアクションを実行するサンプル ワークフローを生成します。ワークフローの生成先のフォルダを選択する必要があります。
    生成したワークフローの名前は、呼び出しスクリプトの事前定義済み文字列と、生成したアクションの名前で構成されます。
    いいえ
    サンプル ワークフローは生成されません。
  6. 送信
    をクリックして、ワークフローを実行します。
生成したアクションをカスタム ワークフローに統合できます。

PowerShell
コマンドレットのアクションの生成

ワークフローを実行して、指定した
PowerShell
コマンドレットとパラメータ セットのアクションを生成できます。このアクションでは、
Automation Orchestrator
PowerShell
機能を使用できます。生成したアクションを実行するサンプル ワークフローを任意で作成することもできます。
  • 管理者として
    Automation Orchestrator
    クライアントにログインしていることを確認します。
  • インベントリ
    ビューから PowerShell ホストへの接続があることを確認します。
PowerShell
スクリプト エンジンを使用して、多数のデータ タイプ セットを使用できます。使用できるデータ タイプには、プリミティブ タイプ(
Integer
Boolean
Char
、および .NET アセンブリで使用可能なタイプなど)やユーザー定義タイプが含まれます。
PowerShell
コマンドレットの定義に基づいてアクションを生成する場合、入力および出力コマンドレット パラメータは、
Automation Orchestrator
プラットフォームがサポートするタイプで表示されます。
PowerShell
プラグインはタイプのマッピングを定義します。一般的に、プリミティブ タイプは対応する
Automation Orchestrator
タイプにマップされ、複雑なタイプは
PowerShellRemotePSObject
オブジェクトによって表示されます。
  1. Automation Orchestrator
    クライアントで
    ライブラリ
    ワークフロー
    の順に移動して、ワークフローの検索ボックスに
    powershell
    および
    generate
    タグを入力します。
  2. PowerShell コマンドレットからのアクションの生成
    ワークフローを見つけて、
    実行
    をクリックします。
  3. コマンドレット
    タブで、生成したアクションを使用する際に実行する
    PowerShell
    コマンドレットを選択します。
  4. コマンドレットのパラメータ セットを選択します。
    パラメータ セットの定義値が
    パラメータ セットの定義
    テキスト ボックスに表示されます。
    パラメータ セットの定義
    テキストボックス内の文字列を編集して、パラメータ セットの定義値を変更することはできません。パラメータ セットに含まれているパラメータ情報の文字列は確認できます。
  5. アクション
    タブの
    名前
    テキストボックスに、生成するアクションの名前を入力して、アクションを生成する既存のモジュールを選択します。
  6. ワークフロー
    タブで、ワークフローを生成するかどうかを選択します。
    オプション
    説明
    はい
    生成したアクションを実行するサンプル ワークフローを生成します。ワークフローの生成先のフォルダを選択する必要があります。
    生成したワークフローの名前は、実行コマンドレットの事前定義済み文字列と、生成したアクションの名前で構成されます。
    いいえ
    サンプル ワークフローは生成されません。
  7. 実行
    をクリックします。
生成したアクションをカスタム ワークフローに統合できます。

アクション間の呼び出し結果の受け渡し

PowerShell
プラグインでは、1 つの
PowerShell
スクリプト呼び出しから別の呼び出しへの結果をパラメータとして受け渡すことができます。結果を正しく受け渡すには、両方の呼び出しが同一のセッションで行われている必要があります。