Aktivität „Gerätesammlungen abrufen“

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 1 Minute Lesedauer

    • Die Aktivität „Gerätesammlungen abrufen“ gibt die Liste der verfügbaren Gerätesammlungen auf einem SCCM-Host (Microsoft System Center Configuration Manager) zurück.

    Die Aktivität „Gerätesammlungen abrufen“ verwendet die PowerShell-Aktivitätsvorlage, um auf die Sammlungen auf dem SCCM-Server zuzugreifen. Die Aktivität ist so konfiguriert, dass ein MID-Server mit Powershell-Fähigkeiten verwendet und ein MID-Server-Skript namens ausgeführt wird GetGerätesammlungen.ps1 Gibt die Gerätesammlungen auf dem Server zurück. Dieses Skript filtert die Ergebnisse des GET-Anweisung, sodass nur bestimmte Attribute für die Gerätesammlungen auf dem SCCM-Server zurückgegeben werden. Durch das Filtern der Ergebnisse auf diese Weise wird die Größe des Payload gesteuert, während gleichzeitig die wünschenswertesten Gerätesammlungsdaten bereitgestellt werden. Die Liste der verfügbaren Sammlungen wird als Array in einem JSON-Objekt zurückgegeben.

    Um auf diese Aktivität im Workflow-Editor zuzugreifen, wählen Sie aus Anwenderdefiniert Registerkarte und navigieren Sie dann zu Anwenderdefinierte Aktivitäten > System Center-Konfigurationsmanager (SCCM)an.

    Hinweis:
    Die Aktivität „Gerätesammlungen abrufen“ verwendet keine Vorverarbeitungsskripts.

    Eingabevariablen

    Tabelle : 1. Eingabevariablen für „Gerätesammlungen abrufen“
    Variable Beschreibung
    sccmServer Der vollqualifizierte Domänenname (FQDN) des SCCM-Servers

    Ausgabevariablen

    Tabelle : 2. Ausgabevariablen für „Gerätesammlungen abrufen“
    Variable Beschreibung
    deviceCollections Die deviceCollectionsArray enthält diese Attribute:
    • id: Primärer Schlüssel der SCCM-Gerätesammlung.
    • name: Name der SCCM-Gerätesammlung.
    • collectionType: Typ der SCCM-Sammlung. In diesem Fall lautet der Wert device.
    • localMemberCount: Anzahl der Mitglieder der Gerätesammlung, die am lokalen SCCM-Standort sichtbar sind.
    • memberCount: Anzahl aller Mitglieder der Gerätesammlung.
    • deviceCollection: Objekt, das den Datensatz der hier aufgeführten Attribute für diese Gerätesammlung enthält. Verwenden Sie das Nachverarbeitungsskript, um zusätzliche Daten aus diesem Datensatz zu analysieren.
    error Variable, die die Aktivitätsausgabefehlermeldung enthält

    Bedingungen

    Tabelle : 3. Bedingungen für „Gerätesammlungen abrufen“
    Bedingung Beschreibung
    Success Die Aktivität hat erfolgreich eine Liste der auf dem SCCM-Host verfügbaren Gerätesammlungen abgerufen.
    Failure Die Aktivität konnte keine Liste der auf dem SCCM-Host verfügbaren Gerätesammlungen abrufen.