[展開を取得] アクティビティ

  • リリースバージョン: Zurich
  • 更新日 2025年07月31日
  • 所要時間:2分
  • [展開を取得] アクティビティは、Microsoft System Center Configuration Manager (SCCM) サーバーを使用してオーケストレーションによって実行された展開のリストを返します。

    [展開を取得] アクティビティは、PowerShell アクティビティテンプレートを使用して SCCM サーバーの展開にアクセスします。アクティビティは、PowerShell 機能を備えた MID サーバーを使用し、ホストの展開を返す GetDeployments.ps1 と呼ばれる MID サーバースクリプトを実行するように設定されています。このスクリプトは GET の結果をフィルタリングするため、SCCM サーバーの展開に対して特定の属性のみが返されます。このような方法で結果をフィルタリングすることで、ペイロードのサイズを制御し、最適な展開データを提供します。使用可能な展開のリストは、JSON オブジェクトのアレイとして返されます。

    ワークフローエディターでこのアクティビティにアクセスするには、[ カスタム ] タブを選択し、 カスタムアクティビティ > System Center Configuration Manager (SCCM).

    注:
    [展開を取得] アクティビティでは、前処理スクリプトは使用されません。

    入力変数

    表 : 1. [展開を取得] 入力変数
    変数 説明
    sccmServer SCCM サーバーの完全修飾ドメイン名 (FQDN)。

    出力変数

    表 : 2. [展開を取得] 出力変数
    変数 説明
    deployments deployments アレイには次の属性が含まれます。
    • id:SCCM アプリケーションのプライマリーキー。
    • applicationId:SCCM アプリケーションのプライマリーキー。
    • softwareName:展開されるソフトウェアの名前。
    • collectionId:SCCM コレクションのプライマリーキー。
    • collectionName:SCCM コレクションの名前。
    • desiredConfigType: 可能な値: Install (1) および Uninstall (2)。
    • deploymentIntent:展開の目的。可能な値は Available (1) および Required (2) です。
    • numberSuccess:展開が正常にインストールされたクライアントの数。
    • numberErrors:展開のインストール時にエラーが発生したクライアントの数。
    • deployment:この展開でここにリスト表示される属性のデータセットを含むオブジェクト。後処理スクリプトを使用し、必要に応じてこのセットから追加データを解析します。
    エラー アクティビティ出力エラーメッセージを含む変数。

    条件

    表 : 3. [展開を取得] 条件
    条件 説明
    成功 アクティビティが SCCM ホストを使用してオーケストレーションによって実行された展開のリストを正常に取得しました。
    失敗 アクティビティが SCCM ホストを使用してオーケストレーションによって実行された展開のリストを取得できませんでした。