Aktivität „Gerätesammlungen abrufen“

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 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 „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).

    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 Array deviceCollections 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 auf der lokalen SCCM-Website sichtbar sind.
    • memberCount: Anzahl aller Mitglieder der Gerätesammlung.
    • deviceCollection: Objekt mit dem Datensatz der hier aufgeführten Attribute für diese Gerätesammlung. 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.