新しいユニット グループを作成します。 親グループは名前で指定できます。指定しない場合は、「コンピュータおよびユーザ」グループの下に新しいユニット グループが作成されます。 検出されたすべてのコンピュータ、および別々の名前で指定された既存のコンピュータを、新しく作成されたユニット グループにリンクさせることができます。 グループ メンバを評価するために新しく作成されたグループに、名前で指定されたクエリを追加できます。
注： パラメータ computerNames を指定し、linkAllComputers を 1（true）に設定した場合は、パラメータ linkAllComputers が優先されます。つまり、computerNames は無視され、ドメインまたはエンタープライズの下で検出されたコンピュータがすべて、新しく作成されたグループにリンクされます。 グループにリンクされるクエリを指定し（動的グループを作成するため）、グループに関連付けられるコンピュータも指定した場合（静的グループを作成するため）、API によってエラーが返されます。
パラメータ
Web サービスへのログインによって取得されたセッション ID を指定します。
作成されるユニット グループの親グループの名前を指定します。 デフォルトでは、「ユーザおよびコンピュータ」グループが親グループとして設定されます。
ユニット グループを作成する場合に要求されるプロパティを指定します。 構造メンバをすべて設定する必要はありません。
グループにリンクされるコンピュータ名のリストを指定します。
ドメインまたはエンタープライズ内に登録されたすべてのコンピュータをグループにリンクします。 true に設定した場合、パラメータ computerNames の値は無視されます。
戻り値
正常に作成された場合、新しいユニット グループの UUID を指定します。
特記事項
パラメータ computerNames に値が割り当てられ（つまり、コンピュータ名のリストが表示され）、パラメータ linkAllComputers も true に設定されている場合、linkAllComputers の値によってパラメータ computerNames の値が上書きされます。
グループにリンクされるクエリ（動的グループを作成するため）とグループに関連付けられるコンピュータ（静的グループを作成するため）を同時に指定した場合、API によってエラーが返されます。
|
Copyright © 2014 CA Technologies.
All rights reserved.
|
|