SharePoint2007Provider::AddGroup

This procedure adds a group to the specified Windows SharePoint Services site. It fails if the group already exists. Rollback deletes the group after adding fails.

Arguments

Input Arguments Required Description

<target>

Yes

The URL of the Windows SharePoint Services administration site.

<siteGUID>

Yes

The globally unique identifier (GUID) of Windows SharePoint Services site collection.

<subSiteGUID>

Yes

The GUID of the subsite.

<groupName>

Yes

The name of the new group.

<ownerIdentifier>

Yes

The string identifying the owner of the cross-site group.

<ownerType>

Yes

The string identifying the type of owner; either user or group.

<defaultUserLoginName>

Yes

The login name of the new cross-site group's default user.

<description>

Yes

The description of the new group.

Remarks

No remarks.

Sample Code

Example XML Request

<request> 
   <procedure> 
      <execute namespace="SharePoint2007Provider" procedure="AddGroup" impersonate="1"> 
         <executeData> 
            <target>https://WSSFE:8080</target> 
            <siteGUID>e97c7d81-5c72-473d-aa28-1d7c6bbcf896</siteGUID> 
            <subSiteGUID>d6322f62-c72f-431c-830c-5b10aecdbb12</subSiteGUID> 
            <groupName>SPNSTestGroup</groupName> 
            <ownerIdentifier>Fabrikam\Administrator</ownerIdentifier> 
            <ownerType>user</ownerType> 
            <defaultUserLoginName>Fabrikam\Administrator</defaultUserLoginName> 
            <description>Add Group Test.</description> 
         </executeData> 
      </execute> 
   </procedure> 
</request>

Applies To

SharePoint 2007 Provider for:

  • Hosted Messaging and Collaboration version 4.5

  • Hosted Messaging and Collaboration version 4.0

See also

Tasks

SharePoint2007Provider::AddGroupToRole
SharePoint2007Provider::RemoveGroup