Set-SPProfileServiceApplicationProxy
設定使用者設定檔服務應用程式之 Proxy 的屬性。
Syntax
Set-SPProfileServiceApplicationProxy
[-Identity] <SPServiceApplicationProxyPipeBind>
[-AssignmentCollection <SPAssignmentCollection>]
[-Confirm]
[-DefaultProxyGroup]
[-MySiteHostLocation <SPSitePipeBind>]
[-MySiteManagedPath <SPPrefixPipeBind>]
[-Name <String>]
[-SiteNamingConflictResolution <String>]
[-WhatIf]
[<CommonParameters>]
Description
Cmdlet Set-SPProfileServiceApplicationProxy
會設定 User Profile Service 應用程式的 Proxy 屬性。
如需適用於 SharePoint 產品的 Windows PowerShell 權限及最新資訊,請參閱線上文件 SharePoint Server Cmdlet。
範例
----------------例子---------------------
$proxy = Get-SPServiceApplicationProxy | ? {$_.TypeName -eq 'User Profile Service Application Proxy'}
Set-SPProfileServiceApplicationProxy -Identity $proxy -SiteNamingConflictResolution 2
本範例會將 User Profile Service 應用程式 Proxy設定為使用網站命名衝突解決,以使用前面加上使用者名稱的功能變數名稱。
參數
-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 |
-Confirm
在執行命令之前,提示您確認操作。
如需詳細資訊,請輸入下列命令:get-help about_commonparameters
。
Type: | SwitchParameter |
Aliases: | cf |
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 |
-DefaultProxyGroup
指定將使用者設定檔服務應用程式新增到本機伺服器陣列的預設 Proxy 群組。
Type: | SwitchParameter |
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 |
-Identity
指定要更新的 User Profile Service 應用程式 Proxy。
此類型必須是格式為 12345678-90ab-cdef-1234-567890bcdefgh 的有效 GUID;有效的服務應用程式 Proxy 名稱 (例如 UserProfileSvcProxy1);或有效之 SPServiceApplicationProxy 物件的執行個體。
Type: | SPServiceApplicationProxyPipeBind |
Position: | 1 |
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 |
-MySiteHostLocation
指定將在其中建立「我的網站」的網站集合。
此類型必須是格式為 12345678-90ab-cdef-1234-567890bcdefgh 的有效 GUID;格式為 https://server_name 的有效 URL;或有效 SPSite 物件的執行個體。
Type: | SPSitePipeBind |
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 |
-MySiteManagedPath
指定個人網站的受管理路徑位置。
類型必須是有效的 URL,格式為 https://server_name.
Type: | SPPrefixPipeBind |
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 |
-Name
指定使用者設定檔服務應用程式的顯示名稱。 所用的名稱在此伺服器陣列中,必須是唯一的使用者設定檔服務應用程式名稱。 名稱最長可包含 128 個字元。
此類型必須是有效服務應用程式 Proxy 的名稱,例如 UserProfileSvcProxy1。
Type: | String |
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 |
-SiteNamingConflictResolution
指定要用來命名個人網站的格式。
使用下列其中一個整數值:
1 個人網站集合是以使用者名稱為基礎,而不需解決任何衝突。 例如,https://portal_site/location/username/
2 個人網站集合是以使用功能變數名稱解決衝突的使用者名稱為基礎。 例如 .../username/ 或 .../domain_username/
3 個人網站集合必須一律使用網域和使用者名稱來命名,以避免任何衝突。 例如,https://portal_site/location/domain_username/
預設值為 1 (不解決衝突)。
Type: | String |
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 |
-WhatIf
顯示訊息會描述命令的功效而不執行命令。
如需詳細資訊,請輸入下列命令:get-help about_commonparameters
。
Type: | SwitchParameter |
Aliases: | wi |
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 |