[デバイス コレクションを取得] アクティビティ

  • リリースバージョン: Zurich
  • 更新日 2025年07月31日
  • 所要時間：2分

    • [デバイス コレクションを取得] アクティビティは、Microsoft System Center Configuration Manager (SCCM) ホストで使用可能なデバイス コレクションのリストを返します。

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

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

    注:
    [デバイス コレクションを取得] アクティビティでは、前処理スクリプトは使用されません。

    入力変数

    表 : 1. [デバイス コレクションを取得] 入力変数
    変数 説明
    sccmServer SCCM サーバーの完全修飾ドメイン名 (FQDN)。

    出力変数

    表 : 2. [デバイス コレクションを取得] 出力変数
    変数 説明
    deviceCollections deviceCollections アレイには次の属性が含まれます。
    • id：SCCM デバイスコレクションのプライマリーキー。
    • name：SCCM デバイスコレクションの名前。
    • collectionType：SCCM ユーザーコレクションのタイプ。この場合、値は device です。
    • localMemberCount：ローカル SCCM サイトで表示可能なデバイスコレクションメンバーの数。
    • memberCount：すべてのデバイスコレクションメンバーの数。
    • deviceCollection：このデバイスコレクションでここにリスト表示される属性のデータセットを含むオブジェクト。後処理スクリプトを使用し、使用するこのセットから追加データを解析します。
    エラー アクティビティ出力エラーメッセージを含む変数。

    条件

    表 : 3. [デバイス コレクションを取得] 条件
    条件 説明
    成功 アクティビティが SCCM ホストで使用可能なデバイス コレクションのリストを正常に取得しました。
    失敗 アクティビティが SCCM ホストで使用可能なデバイス コレクションのリストを取得できませんでした。