New-SPProfileServiceApplicationProxy
適用版本: SharePoint Server 2010
上次修改主題的時間: 2015-03-09
在本機伺服器陣列上建立使用者設定檔服務。
Syntax
New-SPProfileServiceApplicationProxy -Uri <Uri> [-AssignmentCollection <SPAssignmentCollection>] [-Confirm [<SwitchParameter>]] [-DefaultProxyGroup <SwitchParameter>] [-Name <String>] [-PartitionMode <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
New-SPProfileServiceApplicationProxy -ServiceApplication <SPServiceApplicationPipeBind> [-AssignmentCollection <SPAssignmentCollection>] [-Confirm [<SwitchParameter>]] [-DefaultProxyGroup <SwitchParameter>] [-Name <String>] [-PartitionMode <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
詳細描述
New-SPProfileServiceApplicationProxy 可在本機伺服器陣列上建立使用者設定檔服務應用程式 Proxy。此 Proxy 將會加入本機伺服器陣列的預設 Proxy 群組。
Parameters
參數 | 必要 | 類型 | 描述 |
---|---|---|---|
ServiceApplication |
必要 |
Microsoft.SharePoint.PowerShell.SPServiceApplicationPipeBind |
指定要關聯至新 Proxy 的本機使用者設定檔服務應用程式。 此類型必須是格式為 12345678-90ab-cdef-1234-567890bcdefgh 的有效 GUID;有效的訂閱設定檔服務應用程式名稱 (例如 ProfileSvcApp1);或有效之 SPServiceApplication 物件的執行個體。 |
Uri |
必要 |
System.Uri |
此 Proxy 應該與其通訊之遠端使用者設定檔服務應用程式的 URI。只有在規劃要從遠端伺服器陣列連接使用者設定檔服務應用程式時,才需要此值。 |
AssignmentCollection |
選用 |
Microsoft.SharePoint.PowerShell.SPAssignmentCollection |
為能適當處置物件而管理物件。使用 SPWeb 或 SPSite 等物件可能會耗用大量的記憶體,因此在 Windows PowerShell 指令碼中使用這些物件時,必須適當地管理記憶體。您可以使用 SPAssignment 物件將物件指派給變數,並在不需要時處置這些物件,以釋放記憶體。使用 SPWeb、SPSite 或 SPSiteAdministration 物件時,若未使用指派集合或 Global 參數,將會自動處置這些物件。 注意 使用 Global 參數時,所有物件會包含在全域儲存區內。若未立即使用物件,或未使用 Stop-SPAssignment 命令處置物件,將會發生記憶體不足的狀況。 |
Confirm |
選用 |
System.Management.Automation.SwitchParameter |
執行命令之前,會先提示您進行確認。如需詳細資訊,請輸入下列命令:get-help about_commonparameters |
DefaultProxyGroup |
選用 |
System.Management.Automation.SwitchParameter |
指定將使用者設定檔服務應用程式新增到本機伺服器陣列的預設 Proxy 群組。 |
Name |
選用 |
System.String |
指定新使用者設定檔服務應用程式的顯示名稱。所用的名稱在此伺服器陣列中,必須是唯一的使用者設定檔服務應用程式名稱。名稱最長可包含 128 個字元。 此類型必須是有效使用者設定檔服務應用程式 Proxy 的名稱,例如 UserProfileSvcProxy1。 |
PartitionMode |
選用 |
System.Management.Automation.SwitchParameter |
指定服務應用程式需根據網站群組限制資料。設定 PartitionMode 參數並建立服務應用程式之後,就無法變更此值。 |
WhatIf |
選用 |
System.Management.Automation.SwitchParameter |
顯示訊息描述命令效果,而非描述命令執行的效果。如需詳細資訊,請輸入下列命令:get-help about_commonparameters |
輸入類型
傳回類型
Example
--------------------範例---------------------
$app = Get-SPServiceApplication -Name PartitionedUserProfileApplication. New-SPProfileServiceApplicationProxy -Name PartitionedUserProfileApplication_Proxy -ProfileServiceApplication $app -PartitionMode
此範例會建立新的使用者設定檔服務應用程式 Proxy。