Webdienste-Referenz › Methoden › Einheiten und Gruppen › Einheitengruppen › CreateUnitGroupByName

CreateUnitGroupByName

Erstellt eine Einheitengruppe. Sie können die übergeordnete Gruppe anhand des Namens identifizieren. Erfolgt keine Angabe, wird die neue Einheitengruppe in der Gruppe Computer und Benutzer erstellt. Sie können alle erkannten Computer oder vorhandene Computer, deren Namen Sie angeben, mit der neu erstellten Einheitengruppe verknüpfen. Sie können eine anhand des Namens identifizierte Abfrage an die neu erstellt Gruppe anhängen, um die Gruppenmitglieder zu evaluieren.

Hinweis: Wird der Parameter "computerNames" angegeben und "linkAllComputers" auf 1 (true) gesetzt, hat der Parameter "linkAllComputers" Vorrang. Das heißt, "computerNames" wird ignoriert und alle in der Domäne/im Enterprise erkannten Computer werden mit der neu erstellten Gruppe verknüpft. Werden die mit der Gruppe zu verknüpfende Abfrage (zum Erstellen einer dynamischen Gruppe) und die mit der Gruppe zu verknüpfenden Computer (zum Erstellen einer statischen Gruppe) angegeben, gibt die API einen Fehler aus.

Parameter

xsd:string sessionId (o)

Gibt die Sitzungs-ID an, die bei der Webservice-Anmeldung ausgegeben wurde.

xsd:string parentUnitGroupName

Der Name der übergeordneten Gruppe, in der die Einheitengruppe erstellt wird. Standardmäßig ist die Gruppe "Computer und Benutzer" als übergeordnete Gruppe festgelegt.

CreateUnitGroupPropertiesByName unitGroupPropertiesByName (o)

Die für die Erstellung einer Einheitengruppe erforderlichen Eigenschaften. Es ist nicht zwingend erforderlich, alle Mitglieder der Struktur festzulegen.

ArrayOfstring computerNames

Die Liste der mit der Gruppe zu verknüpfenden Computernamen.

xsd:boolean linkAllComputers

Verknüpft alle registrierten Computer in der Domäne oder im Enterprise mit der Gruppe. Wird der Wert auf "True" (Wahr) gesetzt, wird der Parameter "computerNames" ignoriert.

Rückgabewerte

xsd:string uuidOfCreatedUnitGroup

Die UUID der neuen Einheitengruppe nach der erfolgreichen Erstellung.

Anmerkungen

Wird dem Parameter "computerNames" ein Wert zugewiesen (das heißt, die Liste der Computernamen wird angegeben) und der Parameter "linkAllComputers" auf "True" (Wahr) gesetzt, überschreibt der Wert von "linkAllComputers" den Wert des Parameters "computerNames".

Werden sowohl die mit der Gruppe zu verknüpfende Abfrage (zum Erstellen einer dynamischen Gruppe) als auch die mit der Gruppe zu verknüpfenden Computer angegeben (zum Erstellen einer statischen Gruppe), gibt die API einen Fehler aus.

Weitere Informationen:

CreateUnitGroupPropertiesByName