Update-SPProfilePhotoStore
Updates the profile photo store to be compatible with SharePoint Server.
Syntax
Update-SPProfilePhotoStore
-MySiteHostLocation <SPSitePipeBind>
[-AssignmentCollection <SPAssignmentCollection>]
[-CreateThumbnailsForImportedPhotos <Boolean>]
[-NewBaseUri <Uri>]
[-NoDelete <Boolean>]
[-OldBaseUri <Uri>]
[<CommonParameters>] Description
After upgrading from Office SharePoint Server to SharePoint Server, run the Update-SPProfilePhotoStore cmdlet to ensure that the SharePoint profile photo store is compatible with SharePoint Server.
The Update-SPProfilePhotoStore cmdlet should be used only after an upgrade from Office SharePoint Server has completed.
When the Update-SPProfilePhotoStore cmdlet is used, three thumbnail versions with predictable sizes and names are created from the original photo, the new photos are placed into the My Site Host's User Photos library, and the property value in the profile database is updated.
During the operation, the original image is left as-is. If the operation fails for certain users for any reason, it continues on to the next user.
During the migration of profile photos from one server URL to another, one can use the OldBaseUri and NewBaseUri parameters. You just need to specify the starting portion of the URL that has changed from old to new and an attempt to rebase the profile picture URLs will occur.
For example, OldBaseUri: https://server1/my/ProfilePhotos; NewBaseUri: https://server1/my/NewLocation/ProfilePhotos
For permissions and the most current information about Windows PowerShell for SharePoint Products, see the online documentation at SharePoint Server Cmdlets.
Examples
------------------EXAMPLE-------------------
Update-SPProfilePhotoStore -MySiteHostLocation https://mysitesThis example uploads photos to a specified My Site host location.
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: | SharePoint Server Subscription Edition |
-CreateThumbnailsForImportedPhotos
Creates thumbnails for all the imported user profile pictures.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-MySiteHostLocation
Specifies the URL for the My Site host location where the photos are to be uploaded.
| Type: | SPSitePipeBind |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-NewBaseUri
Specifies the new URL for profile pictures. For example, https://server2/.
| Type: | Uri |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-NoDelete
When the value is set to true, imported user profile picture files will be preserverd after creating thumbnails for them.
Note
This will only work when CreateThumbnailsForImportedPhotos is set to $true
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-OldBaseUri
Specifies the old URL for profile pictures. For example, https://server1/.
| Type: | Uri |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |