Manuel de référence des services Web › Méthodes › Unités et groupes › Groupes d'unités › CreateUnitGroup2

CreateUnitGroup2

Crée un groupe d'unités. Si vous ne spécifiez pas le groupe parent, le nouveau groupe d'unités est créé sous le groupe Ordinateurs et utilisateurs. Vous pouvez lier les ordinateurs existants au groupe d'unités nouvellement créé en spécifiant leur UUID ou vous pouvez lier tous les ordinateurs détectés au groupe d'unités. Vous pouvez joindre une requête, indiquée par son ?UUID, au groupe nouvellement créé pour l'évaluation des membres du groupe.

Remarque : Lorsque le paramètre computerUUIDS est spécifié et linkAllComputers défini sur True (Vrai), le paramètre linkAllComputers est prioritaire, ce qui signifie que les computerIds sont ignorés et que tous les ordinateurs détectés sous le domaine ou l'entreprise sont liés au groupe nouvellement créé. Lorsque la requête à lier au groupe est spécifiée (pour créer un groupe dynamique) et que les ordinateurs à associer au groupe sont également spécifiés (pour créer un groupe statique), l'API renvoie une erreur.

Paramètres

xsd:string sessionId (m)

Indique l'ID de session obtenu lors de la connexion au service Web.

xsd:string parentUnitGroupId

Spécifie l'UUID du groupe parent pour le groupe d'unités à créer. Par défaut, le groupe Ordinateur et utilisateur est défini comme groupe parent.

CreateUnitGroupProperties2 createUnitGroupProperties (m)

Spécifie les propriétés requises pour créer un groupe d'unités. La définition de tous les membres de la structure n'est pas obligatoire.

ArrayOfstring computerUUIDS

Spécifie la liste des ?U?U?I?D d'ordinateur à lier au groupe.

xsd:boolean linkAllComputers

Lie tous les ordinateurs enregistrés dans le domaine ou l'entreprise au groupe. Si elle est définie sur True (Vrai), la valeur du paramètre computerUUIDs est ignorée.

Valeurs de retour

xsd:string uuidOfCreatedUnitGroup

Indique l'UUID du nouveau groupe d'unités, s'il a été créé avec succès.

Remarques

Si le paramètre computerUUIDS est affecté à une valeur (c'est-à-dire que la liste des ?U?UID d'ordinateur est fournie et le paramètre linkAllComputers est défini sur True (Vrai)), la valeur de linkAllComputers remplace la valeur du paramètre computerUUIDS.

Si la requête à lier au groupe (créant un groupe dynamique) et les ordinateurs à associer au groupe (créant un groupe statique) sont spécifiés en même temps, l'API renvoie une erreur.

Informations complémentaires :

CreateUnitGroupProperties2