---
sourceDocument: Yokohama データと自動化
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/yokohama/integrate-applications

 Release :

    - yokohama

ft:locale :

    - ja-JP

ft:publication_title :

    - Yokohama データと自動化

ft:clusterId :

    - crint

bundleId :

    - crint

workflow :

    - Creator


---

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

# \[デバイス コレクションを取得\] アクティビティ {#ariaid-title1}

* リリースバージョン: Yokohama
* 
* 更新日 2025年01月30日
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：2分

\[デバイス コレクションを取得\] アクティビティは、Microsoft System Center Configuration Manager (SCCM) ホストで使用可能なデバイス コレクションのリストを返します。
\[デバイス コレクションを取得\] アクティビティは、[PowerShell アクティビティテンプレート](https://servicenow-prod.fluidtopics.net/YIFjK9VurG8Gt1MVOuEAJg#t_CreateAPowershellActivity "Microsoft PowerShell を使用してホストからワークフローにデータを返すために、カスタム PowerShell アクティビティを作成します。")を使用して SCCM サーバーのコレクションにアクセスします。アクティビティは、PowerShell 機能を備えた MID サーバーを使用し、サーバーのデバイス コレクションを返す GetDeviceCollections.ps1 と呼ばれる MID サーバースクリプトを実行するように設定されています。このスクリプトは GET の結果をフィルタリングするため、SCCM サーバーのデバイス コレクションに対して特定の属性のみが返されます。このような方法で結果をフィルタリングすることで、ペイロードのサイズを制御し、最適なデバイス コレクション データを提供します。使用可能なコレクションのリストは、JSON オブジェクトのアレイとして返されます。{#r_GetDeviceCollectionsActivity__p_AccessSSHCustomActivities}

ワークフローエディターでこのアクティビティにアクセスするには、\[ カスタム\] タブを選択し、 カスタムアクティビティSystem Center Configuration Manager (SCCM).  
注:  
\[デバイス コレクションを取得\] アクティビティでは、前処理スクリプトは使用されません。

## 入力変数

{#r_GetDeviceCollectionsActivity__table_jhr_xbd_3s__entry__2}

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

{#r_GetDeviceCollectionsActivity__table_jhr_xbd_3s}

## 出力変数

{#r_GetDeviceCollectionsActivity__table_o5d_wpm_xs__entry__2}

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

{#r_GetDeviceCollectionsActivity__table_o5d_wpm_xs}

## 条件

{#r_GetDeviceCollectionsActivity__table_emz_zpm_xs__entry__2}

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

{#r_GetDeviceCollectionsActivity__table_emz_zpm_xs}