Update-SPProfilePhotoStore

更新設定檔相片存放區與 SharePoint Server 相容。

Syntax

Update-SPProfilePhotoStore
      -MySiteHostLocation <SPSitePipeBind>
      [-AssignmentCollection <SPAssignmentCollection>]
      [-CreateThumbnailsForImportedPhotos <Boolean>]
      [-NewBaseUri <Uri>]
      [-NoDelete <Boolean>]
      [-OldBaseUri <Uri>]
      [<CommonParameters>]

Description

從 Office SharePoint Server 升級至 SharePoint Server 之後,請執行 Update-SPProfilePhotoStore Cmdlet 以確保 SharePoint 設定檔相片存放區與 SharePoint Server 相容。 只有在 Update-SPProfilePhotoStore 從 Office SharePoint Server 升級完成之後,才應該使用 Cmdlet。 使用 Cmdlet Update-SPProfilePhotoStore 時,會從原始相片建立具有可預測大小和名稱的三個縮圖版本、將新相片放入「我的網站主機」的使用者相片庫,並更新設定檔資料庫中的屬性值。

在作業期間,原始的圖像會保持不變。 其中如有部分使用者的作業因故失敗,會繼續下一位使用者。

在將設定檔照片從一個伺服器 URL 移轉到另一個伺服器 URL 時,可以使用 OldBaseUri 及 NewBaseUri 參數。 您只需要指定已從舊變新的 URL 的開始部分,就會嘗試為設定檔圖片 URL 重定基底。

例如,OldBaseUri: https://server1/my/ProfilePhotos ;NewBaseUri: https://server1/my/NewLocation/ProfilePhotos

如需適用於 SharePoint 產品的 Windows PowerShell 權限及最新資訊,請參閱線上文件 SharePoint Server Cmdlet

範例

------------------例子-------------------

Update-SPProfilePhotoStore -MySiteHostLocation https://mysites

此範例會將相片上傳至所指定之「我的網站」主機位置。

參數

-AssignmentCollection

管理物件以適當處置它們。 使用 SPWeb 或 SPSite 等物件可能會耗用大量的記憶體,因此在 Windows PowerShell 指令碼中使用這些物件時,必須適當地管理記憶體。 您可以使用 SPAssignment 物件將物件指派給變數,並在不需要時處置這些物件,以釋放記憶體。 使用 SPWeb、SPSite 或 SPSiteAdministration 物件時,若未使用指派集合或 Global 參數,將會自動處置這些物件。

使用 Global 參數時,所有物件會包含在全域儲存區內。 如果不立即使用物件,或使用 Stop-SPAssignment 命令加以捨棄,則可能會有記憶體不足的狀況發生。

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

-CreateThumbnailsForImportedPhotos

為所有匯入的使用者設定檔圖片建立縮圖。

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-MySiteHostLocation

指定接收上傳相片之「我的網站」主機位置的 URL。

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

-NewBaseUri

為設定檔圖片指定新的 URL。 例如,https://server2/.

Type:Uri
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-NoDelete

當值設定為 true 時,為其建立縮圖之後,將會保留匯入的使用者設定檔圖片檔案。

注意事項

只有當 CreateThumbnailsForImportedPhotos 設定為 時,此功能才適用 $true

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-OldBaseUri

為設定檔圖片指定舊的 URL。 例如,https://server1/.

Type:Uri
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019