Ruft die Aktivität „Gerätesammlungen“ ab

  • Freigeben Version: Australia
  • Aktualisiert 12. März 2026
  • 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 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-Serverskript ausgeführt wird GetGerätesammlungen.ps1 Gibt die Gerätesammlungen auf dem Server zurück. Dieses Skript filtert die Ergebnisse des ABRUFS, 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 der Nutzlast gesteuert und gleichzeitig die wünschenswertesten Gerätesammlungsdaten bereitgestellt. 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 aus Anwenderdefiniert Registerkarte und navigieren Sie dann zu Anwenderdefinierte Aktivitäten > Systemcenter-Konfigurationsmanager (SCCM)an.

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

    Eingabevariablen

    Tabelle : 1. Ruft Eingabevariablen für Gerätesammlungen ab
    Variable Beschreibung
    SccmServer Der vollqualifizierte Domänenname (FQDN) des SCCM-Servers.

    Ausgabevariablen

    Tabelle : 2. Ruft Ausgabevariablen für Gerätesammlungen ab
    Variable Beschreibung
    DeviceSammlungen 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 ist der Wert Gerät .
    • 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 von Attributen enthält, die hier für diese Gerätesammlung aufgeführt sind. Verwenden Sie das Nachverarbeitungsskript, um zusätzliche Daten aus diesem Satz zur Verwendung zu analysieren.
    Fehler Variable, die die Fehlermeldung für die Aktivitätsausgabe enthält.

    Bedingungen

    Tabelle : 3. Rufen Sie die Bedingungen für Gerätesammlungen ab
    Bedingung Beschreibung
    Erfolg Aktivität hat eine Liste der Gerätesammlungen erfolgreich abgerufen, die auf dem SCCM-Host verfügbar sind.
    Fehler Aktivität konnte keine Liste der auf dem SCCM-Host verfügbaren Gerätesammlungen abrufen.