Aktivität „Gerätesammlungen abrufen“

  • Freigeben Version: Xanadu
  • Aktualisiert 1. August 2024
  • 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 das MID Server-Skript GetDeviceCollections.ps1 ausgeführt wird, das die Gerätesammlungen auf dem Server zurückgibt. 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 im Workflow-Editor auf diese Aktivität zuzugreifen, wählen Sie die Registerkarte Anwenderdefiniert, und navigieren Sie dann zu Anwenderdefinierte Aktivitäten > System Center Configuration Manager (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 Das deviceCollections-Array enthält folgende Attribute:
    • id: Primärer Key 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 aufgelisteten 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.