Web サービス リファレンス › メソッド › ユニットおよびグループ › ユニット グループ › CreateUnitGroup2

CreateUnitGroup2

新しいユニット グループを作成します。 親グループを指定しない場合は、「コンピュータおよびユーザ」グループの下に新しいユニット グループが作成されます。 UUID を指定して、既存のコンピュータを新しく作成したユニット グループにリンクさせることができます。または、検出されたすべてのコンピュータをユニット グループにリンクさせることができます。 グループ メンバを評価するために新しく作成されたグループに、UUID で指定されたクエリを追加できます。

注： パラメータ computerUUIDS を指定し、linkAllComputers を true に設定した場合は、パラメータ linkAllComputers が優先されます。つまり、computerIds は無視され、ドメインまたはエンタープライズの下で検出されたコンピュータはすべて、新しく作成されたグループにリンクされます。 グループにリンクされるクエリを指定し（動的 グループを作成するため）、グループに関連付けられるコンピュータも指定した場合（静的グループを作成するため）、API によってエラーが返されます。

パラメータ

xsd:string sessionId (m)

Web サービスへのログインによって取得されたセッション ID を指定します。

xsd:string parentUnitGroupId

作成されるユニット グループの親グループの UUID を指定します。 デフォルトでは、「ユーザおよびコンピュータ」グループが親グループとして設定されます。

CreateUnitGroupProperties2 createUnitGroupProperties (m)

ユニット グループを作成する場合に要求されるプロパティを指定します。 構造メンバをすべて設定する必要はありません。

ArrayOfstring computerUUIDS

グループにリンクされるコンピュータ UUID のリストを指定します。

xsd:boolean linkAllComputers

ドメインまたはエンタープライズ内に登録されたすべてのコンピュータをグループにリンクします。 true に設定した場合、パラメータ computerUUIDs の値は無視されます。

戻り値

xsd:string uuidOfCreatedUnitGroup

正常に作成された場合、新しいユニット グループの UUID を指定します。

特記事項

パラメータ computerUUIDS に値が割り当てられる場合（つまり、コンピュータ UUID のリストが表示され、パラメータ linkAllComputers が true に設定されている場合）、linkAllComputers の値によってパラメータ computerUUIDS の値が上書きされます。

グループにリンクされるクエリ（動的グループを作成するため）とグループに関連付けられるコンピュータ（静的グループを作成するため）の両方を同時に指定した場合、API によってエラーが返されます。

関連項目：

CreateUnitGroupProperties2