Aktivität „Benutzersammlungen abrufen“

  • Freigeben Version: Washingtondc
  • Aktualisiert 1. Februar 2024
  • 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 das MID Server-Skript GetUserCollections.ps1 ausgeführt wird, das die Benutzersammlungen 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 Benutzerdefiniert aus und navigieren dann zu Benutzerdefinierte Aktivitäten > System Center-Konfigurationsmanager (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 userCollections-Array enthält folgende Attribute:
    • id: Primärer Key der SCCM-Benutzersammlung
    • name: Name der SCCM-Benutzersammlung
    • collectionType: Typ der SCCM-Sammlung. In diesem Fall lautet der Wert user.
    • localMemberCount: CAnzahl der Mitglieder der Benutzersammlung, die am lokalen SCCM-Standort sichtbar sind.
    • memberCount: Anzahl aller Mitglieder der Benutzersammlung
    • userCollection: Objekt, das den Datensatz der hier aufgelisteten Attribute für diese Benutzersammlung 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 „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.