Sync-SPProjectPermissions

Module:

SharePointServer

Applies to:

Project Server 2013, Project Server 2016, Project Server 2019

Manually synchronizes permissions between a Project Web App instance and its associated project sites.

Syntax

Sync-SPProjectPermissions
    [-Url] <Uri>
    [-SyncPWASite]
    [-SyncProjectSites]
    [-Async]
    [-AssignmentCollection <SPAssignmentCollection>]
    [<CommonParameters>]

Sync-SPProjectPermissions
    [-Url] <Uri>
    [[-Type] <SharePointPermissionModeSyncType>]
    [-AssignmentCollection <SPAssignmentCollection>]
    [<CommonParameters>]

Description

The Sync-SPProjectPermissions cmdlet causes permissions to be synchronized to the project sites associated with projects in a Project Web App instance and the permissions set on those projects in Project Server.

This cmdlet works with both SharePoint permission mode and Project Server permission mode.

For permissions and the most current information about Windows PowerShell for Project Server, see the online documentation at https://go.microsoft.com/fwlink/p/?LinkId=251833 (https://go.microsoft.com/fwlink/p/?LinkId=251833).

Examples

--------------EXAMPLE-----------------

Sync-SPProjectPermissions -Url https://pwa_site -Type Full

Performs a full sync against the PWA site https://pwa_site.

Parameters

-AssignmentCollection

Manages objects for the purpose of proper disposal. Use of objects, such as SPWeb or SPSite, can use large amounts of memory and use of these objects in Windows PowerShell scripts requires proper memory management. Using the SPAssignment object, you can assign objects to a variable and dispose of the objects after they are needed to free up memory. When SPWeb, SPSite, or SPSiteAdministration objects are used, the objects are automatically disposed of if an assignment collection or the Global parameter is not used.

When the Global parameter is used, all objects are contained in the global store. If objects are not immediately used, or disposed of by using the Stop-SPAssignment command, an out-of-memory scenario can occur.

Type:	SPAssignmentCollection
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Project Server 2013, Project Server 2016, Project Server 2019

-Async

Specifies that the synchronization is placed in the Project Server queue. Omitting this flag causes the synchronization to occur immediately within the Windows PowerShell console.

This parameter is used with Project Server permission mode.

Type:	SwitchParameter
Position:	4
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Project Server 2013, Project Server 2016, Project Server 2019

-SyncProjectSites

Triggers a synchronization of Project Server permissions to the project sites.

This parameter is used with Project Server permission mode.

Type:	SwitchParameter
Position:	3
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Project Server 2013, Project Server 2016, Project Server 2019

-SyncPWASite

Triggers a synchronization of Project Server permissions to the PWA site.

This parameter is used with Project Server permission mode.

Type:	SwitchParameter
Position:	2
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Project Server 2013, Project Server 2016, Project Server 2019

-Type

Specifies the type of sync to perform: full or incremental.

This parameter is used with SharePoint permission mode.

Valid values are:

Full, Incremental, AllGroups

Type:	SharePointPermissionModeSyncType
Position:	2
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Project Server 2013, Project Server 2016, Project Server 2019

-Url

Specifies the URL of the Project Web App instance for which you want to synch permissions.

The type must be a valid URL, in the form https://pwa_site.

Type:	Uri
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Project Server 2013, Project Server 2016, Project Server 2019