ナビ付きでトピックを開く

The Power Shell Command action runs a Windows PowerShell command.

You can configure the following properties for the Power Shell Command action:

アクション

• 名前: 操作の名前を指定します。 必要な場合は、フィールドに新しい名前を入力して既定名を置き換えられます。

• 説明: 操作の説明を保存できます。

• Run Action: 操作を実行する頻度を指定できます。

  • 常に: Integration Service で統合が実行されるたびに操作が実行されます。

  • しない: Integration Service での統合の実行時に操作は実行されません。

  • Conditionally, based on variable: Specifies that the Integration Service will run the action only when a selected variable meets a specified condition. このオプションは、操作を実行するかどうかを決定する条件が 1 つのみの場合に使用してください。 このオプションを有効にすると、表示される入力ボックスに条件ステートメントを作成できます。

    入力ボックスコントロール

    • 変数: 条件ステートメントに使用する変数を入力します。 Alternatively, you can add a variable for the conditional statement value.

    • [Relational Operator]: 条件ステートメントに使用するリレーショナル演算子を指定します。 既存の演算子をクリックすると、追加の演算子のリストが表示され、使用する演算子を選択できます。 For more information, refer to Relational Operators. The operators available in the list depend on whether you have selected Text or Decimal for the Type option.

    • 値: Specifies the value(s) to use for the conditional statement. Some operators, such as Is null and Is not null, do not require a value to be specified. In these situations, the Value field is not available.

    • 種類: Specifies whether the conditional statement is evaluating a text or decimal value.

       

  • 式に基づく条件に従う: Specifies the conditions under which the Integration Service will run the action. このオプションは、条件ステートメントが複数必要な場合に使用します。 このオプションを有効にすると、必要な条件ステートメントを作成することによって、表示された入力ボックスに条件式を作成できます。 You create and edit your conditional expression on the Tree View tab. Click the Text View tab to see a read-only text view of the conditional expression.

    入力ボックスコントロール (ツリービュータブ)

    • [Conditional Joiner]: グループ内の条件ステートメントの条件付き結合子を指定します。 The default conditional joiner is And.

      既存の条件付き結合子をクリックすると、以下のいずれかの方法で条件式を設定できるメニューが表示されます。

      • Select a different conditional joiner: The menu options include a list of conditional joiners. 条件ステートメントで使用する条件付き結合子を選択します。 For more information about the supported conditional joiners, see Conditional Joiners.

      • Add Condition: クリックして現在のグループに他の条件ステートメントを追加します。

      • Add Group: Click to add a sub-group of conditional statements to the current group.

      • Remove Group: メニューがサブグループから開かれたときに表示されます。 クリックしてサブグループを削除します。

      • Clear All: メニューが最上位グループから開かれたときに表示されます。 クリックすると、すべての条件ステートメント (サブグループを含め) が削除されます。

    • : 式内の各条件付き結合子の右隣に表示されます。 クリックすると、その結合子に関連づけられたグループに条件ステートメントが追加されます。

    • : 既存の条件ステートメントにカーソルを載せると表示されます。 Click to delete the conditional statement.

    • 変数: 条件ステートメントに使用する変数を入力します。 Alternatively, you can add a variable for the conditional statement.

    • [Relational Operator]: 条件ステートメントに使用するリレーショナル演算子を指定します。 既存の演算子をクリックすると、追加の演算子のリストが表示され、使用する演算子を選択できます。 For more information, refer to Relational Operators. The operators available in the list depend on whether you have selected Text or Decimal for the Type option.

    • 値: Specifies the value(s) to use for the conditional statement. Some operators, such as Is null and Is not null do not require a value to be specified. このような場合、値フィールドは非表示になります。

    • 種類: Specifies whether the conditional statement is evaluating a text or decimal value.

コマンド

• ソース: 送信されるコマンドのソースを指定します。

  • 埋め込みコマンド:

  • 値: 表示される入力ボックスを使用して、操作で使用するデータを入力します。 Alternatively, you can add a variable to specify the data, or add a special character to the value you have entered.

  • インポート: 必要なデータを含むファイルを参照して選択できる [ファイルを開く] ダイアログが開きます。 ファイルの内容が、[値] 入力ボックスにインポートされます。

  • エクスポート: [値] 入力ボックスの内容を外部ファイルに保存できる [ファイルの保存] ダイアログが開きます。 値を新しいファイルとして保存するか、または既存ファイルの内容と置換できます。

  • 変数:

    • 変数: ソースに使用する変数を入力します。 または、変数を追加できます。

  • 外部ファイル:

    • 場所: ソースフォルダが存在するファイルシステムを指定します。 File systems or locations can include local file systems or network shares, Librarian, or a supported cloud storage location. For more information about supported cloud storage locations, see Administration Console's Cloud Storage Page.

    • ファイル名: ファイルパスを指定します。 フォルダの場所とファイル名を入力するか、[参照] をクリックして参照し、目的のファイルを選択します。 Alternatively, you can add a variable to specify the desired file, or add a special character to the value you have entered.

    • ファイルのエンコーディング: ソースファイルによって使用されるエンコーディングを指定します。

• コマンドの完了を待機: Specifies that the command is not executed until after a response is received. 有効に設定しない場合、応答を待たずにコマンドは実行されます。

  • 実行タイムアウト (秒): Specifies the amount of time the action allows for command execution before the action times out and exits.

出力

• コマンド出力をメッセージログに送信: Logs the shell command output to the message log.

For each of the following options, you can enter the variable that you want. または、変数を追加できます。

• コマンド出力とエラーを変数に保存: コマンド出力とエラーが保存される変数を指定します。

• コマンドエラーを変数に保存: コマンドエラーが保存される変数を指定します。

• コマンド例外を変数に保存: コマンド例外が保存される変数を指定します。

テスト: PowerShell コマンド

• テスト: 操作を実行します。 The Message pane displays information on the success or failure of the action.

  Clicking the Test button executes the action only and does not run the integration. このため、使用するよう設定した統合からのデータは使用せずに操作が実行されます。 For information on testing your integration, refer to Using the Test Pane.

ログオン設定

• Inherit from parent action: When enabled, the action inherits the user account credentials specified on the Actions property page. Alternatively, if the action is part of a Group action, it will inherit the user account credentials specified on the immediate parent Group action’s property page.

• ユーザーの認証情報を指定: このオプションを有効にすると、操作は、指定された資格情報を使用して実行されます。

エラー処理および診断

• Ignore errors and continue running actions: このオプションを有効にすると、操作が失敗したときに他の操作の実行が継続されます。

  このプロパティが有効でない場合は、操作が失敗したときの動作は以下のシナリオによって異なります。 If you have specified Sequentially for the Execute Actions property of the selected action's hierarchical Actions or Group property page, no further actions within that group are executed. If you have specified In Parallel for the Execute Actions property of the action's hierarchical Actions or Group property page, the actions within that same group are not affected; the errors are ignored and the other actions within the group are executed. If the selected action is within a Group action, no actions outside of that Group action are affected.

• Retry if failed: このオプションを有効にすると、操作が失敗したときに操作の実行が再試行されます。

• Maximum retries: 操作の実行の最大再試行回数を指定します。 Available when Retry if failed is enabled.

• Retry interval: 操作の失敗時に操作の実行を再試行するまでの時間を指定します。 Available when Retry if failed is enabled.