Share via


HostedSharePoint2007::AddGroup

This procedure adds a SharePoint group to the customer's site collection or subsite.

Arguments

Input Arguments Required Description

<preferredDomainController>

Yes

The name of the preferred domain controller

<org>

Yes

The Lightweight Directory Access Protocol (LDAP) path of the organization that owns the site

<target>

Yes

The URL of the Windows SharePoint administration site. The SharePoint provider uses this URL as the target for issueing provisioning requests. It is important that you ensure that this is both a valid URL and is the URL of a trusted Windows SharePoint Front-End server in your environment. This parameter should not be based on end user input. Please see the note above (need a clear way to identify the note) for more details.

<siteName>

No (However at least one of "siteName" and "site" should be in input parameters)

The site name which is unique within org. It holds a pointer to the name of the sharepoint.

<site>

No (However at least one of "siteName" and "site" should be in input parameters)

The absolute URL of the site to be deleted. This is the URL that a user would enter to access the site, for example: https://localhost/sites/sp.

<groupName>

Yes

The name of the group to be added

<ownerUserPrincipalName>

Yes

The user principal name (UPN) of the group owner

<ownerType>

Yes

The type of the owner account; either 'group' or 'user'.

<defaultUserPrincipalName>

Yes

The user principal name (UPN) of the default user

<description>

Yes

The description of the group to be added

Remarks

Procedure Step

  • Add group by calling ManagedSharePoint2007::AddGroup.

Security

  • Impersonate Caller.

  • Caller Tested for siteOwner permissions: UserCreators OrgCreators Domain Administrators.

Sample Code

Example XML Request

<request> 
        <procedure> 
                <execute namespace="HostedSharePoint2007" procedure="AddGroup" impersonate="1"> 
                        <executeData> 
                                <org>LDAP://ou=alpineskihouse,ou=consolidatedmessenger,ou=hosting,dc=fabrikam,dc=com</org> 
                                <preferredDomainController>ad01-wh.fabrikam.com</preferredDomainController> 
                                <target>https://app01-ra:22778</target> 
                                <site>https://app01-ra:8081/sites/testsite3/subsite1</site> 
                                <siteName>subsitetest</siteName> 
                                <groupName>TestGroup</groupName> 
                                <ownerUserPrincipalName>owner@org.com</ownerUserPrincipalName> 
                                <ownerType>user</ownerType> 
                                <defaultUserPrincipalName>defaultUser@org.com</defaultUserPrincipalName> 
                        </executeData> 
                </execute> 
        </procedure> 
</request>

Applies To

Hosted SharePoint 2007 Namespace for

  • Hosted Messaging and Collaboration version 4.5

  • Hosted Messaging and Collaboration version 4.0

See also

Tasks

HostedSharePoint2007::RemoveGroup