Aktivität „Benutzersammlungen abrufen“

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 1 Minute Lesedauer
  • Die Aktivität „Benutzersammlungen abrufen“ gibt die Liste der verfügbaren Benutzersammlungen auf einem SCCM-Server (Microsoft System Center Configuration Manager) zurück.

    Die Aktivität „Benutzersammlungen abrufen“ verwendet die PowerShell-Aktivitätsvorlage, um auf die Benutzersammlungen 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 „GetUserCollections.ps1 “ ausgeführt wird, das die Anwendersammlungen auf dem Host zurückgibt. Dieses Skript filtert die Ergebnisse des GET-Anweisung, sodass nur bestimmte Attribute für die Benutzersammlungen 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 Benutzersammlungsdaten 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 „Benutzersammlungen abrufen“ verwendet keine Vorverarbeitungsskripts.

    Eingabevariablen

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

    Ausgabevariablen

    Tabelle : 2. Ausgabevariablen für „Benutzersammlungen abrufen“
    Variable Beschreibung
    userCollections Das Array userCollections enthält diese Attribute:
    • id: Primärer Schlüssel der SCCM-Anwendersammlung.
    • name: Name der SCCM-Anwendersammlung.
    • collectionType: Typ der SCCM-Sammlung. In diesem Fall lautet der Wert user.
    • localMemberCount: Anzahl der Mitglieder der Anwendersammlung, die auf der lokalen SCCM-Website sichtbar sind.
    • memberCount: Anzahl aller Mitglieder der Anwendersammlung.
    • userCollection: Objekt mit dem Datensatz der hier aufgeführten Attribute für diese Anwendersammlung. 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 „Benutzersammlungen abrufen“
    Bedingung Beschreibung
    Success Die Aktivität hat erfolgreich die Liste der verfügbaren Benutzersammlungen auf einem SCCM-Host abgerufen.
    Failure Die Aktivität konnte die Liste der verfügbaren Benutzersammlungen auf einem SCCM-Host nicht abrufen.