Following are the PowerShell cmdlets and xml syntax for the ControlPoint Duplicate User Permissions action.
PowerShell Parameters
Parameter |
Description |
---|---|
Duplicate-UserPermissions |
The cmdlet name |
-Type |
The level of the hierarchy containing the SharePoint object(s) that will be acted on. Valid values are: §FARM §WAP §SITE §WEB |
-Url |
The url of the SharePoint object to act on. NOTE: If the action is to be performed on a farm, Web application, or site collection, you can use the url for any site within that scope. |
-IncludeChildren |
An indication of whether you want the action to include child sites.
·If -Type is FARM, WAP, or SITE, $true is the only valid value. ·If -Type is WEB, valid values are $true or $false.
NOTE: If this parameter is omitted: ·for FARM, WAP, or SITE, a value of true will be assumed ·for WEB, a value of false will be assumed. |
-DestinationUserNames |
Login name(s) of the user(s) to whom permissions will be duplicated. Enter multiple login names as a comma-separated list. |
-ModelUserName |
Login name of the user whose permissions you want to duplicate. |
-TaskAuditPath (Optional) |
If you want to save a ControlPoint Task Audit for the action as a .pdf file, the path to the directory where you want the file to be saved. |
Example PowerShell Cmdlet with Parameters
Duplicate-UserPermissions -Type WAP -url 2013sharepoint/sites/alpha -IncludeChildren $true -DestinationUserNames 2013sharepoint\margaretmeade,2013sharepoint\isaacasimov -ModelUserName2013sharepoint\jamesjoyce -TaskAuditPath C:\temp\TaskAudits
xml Tags
REMINDER: Xml templates for ControlPoint actions are located in the folder C:\Program Files\Metalogix\ControlPoint\Support\Powershell.
Tags |
Description |
---|---|
<DuplicateUserPermissionsContract...> |
The action to be performed |
<SharePointObjects> |
The container for all of the objects that you want to include in the operation. |
<SharePointObject> |
The container for the current object. |
<SPHierarchyLevel> |
The level of the hierarchy for the SharePoint object(s) that will be acted on. Valid values are: ·FARM ·WAP ·SITE ·WEB |
<Url> |
The url of the SharePoint object to act on. |
<IncludeChildren> |
An indication of whether you want the action to include child sites. §If SPHierarchyLevel=FARM, WAP, or SITE, true is the only valid value. §If SPHierarchyLevel=WEB, valid values are true or false. |
<Url> |
The url of the SharePoint object to act on. NOTE: If the action is to be performed on a farm, Web application, or site collection, you can use the url for any site within that scope. |
<DestinationUserNames> <string> |
Login name(s) of the user(s) to whom permissions will be duplicated. Enter each login name as a separate string. |
<ModelUserName> |
Login name of the user whose permissions will be duplicated. |
<TaskAuditPath> (Optional) |
If you want to save a ControlPoint Task Audit for the action as a .pdf file, the path to the directory where you want the file to be saved. |
Example xml File Contents
PowerShell Comand to Run xml
Duplicate-UserPermissions -FilePath C:\xml\DuplicateUserPermissions.xml
© ALL RIGHTS RESERVED. Terms of Use Privacy Cookie Preference Center