共用方式為


New-SPProfileServiceApplication

 

適用版本: SharePoint Server 2010

上次修改主題的時間: 2015-03-09

新增使用者設定檔服務應用程式至伺服器陣列。

Syntax

New-SPProfileServiceApplication -ApplicationPool <SPIisWebServiceApplicationPoolPipeBind> [-AssignmentCollection <SPAssignmentCollection>] [-Confirm [<SwitchParameter>]] [-MySiteHostLocation <SPSitePipeBind>] [-Name <String>] [-PartitionMode <SwitchParameter>] [-ProfileDBCredentials <PSCredential>] [-ProfileDBFailoverServer <String>] [-ProfileDBName <String>] [-ProfileDBServer <String>] [-ProfileSyncDBCredentials <PSCredential>] [-ProfileSyncDBFailoverServer <String>] [-ProfileSyncDBName <String>] [-ProfileSyncDBServer <String>] [-SocialDBCredentials <PSCredential>] [-SocialDBFailoverServer <String>] [-SocialDBName <String>] [-SocialDBServer <String>] [-WhatIf [<SwitchParameter>]]

New-SPProfileServiceApplication -ApplicationPool <SPIisWebServiceApplicationPoolPipeBind> -MySiteHostLocation <SPSitePipeBind> [-AssignmentCollection <SPAssignmentCollection>] [-Confirm [<SwitchParameter>]] [-MySiteHostLocation <SPSitePipeBind>] [-MySiteManagedPath <SPPrefixPipeBind>] [-Name <String>] [-PartitionMode <SwitchParameter>] [-ProfileDBCredentials <PSCredential>] [-ProfileDBFailoverServer <String>] [-ProfileDBName <String>] [-ProfileDBServer <String>] [-ProfileSyncDBCredentials <PSCredential>] [-ProfileSyncDBFailoverServer <String>] [-ProfileSyncDBName <String>] [-ProfileSyncDBServer <String>] [-SiteNamingConflictResolution <String>] [-SocialDBCredentials <PSCredential>] [-SocialDBFailoverServer <String>] [-SocialDBName <String>] [-SocialDBServer <String>] [-WhatIf [<SwitchParameter>]]

詳細描述

此 Cmdlet 包含一個以上的參數集。您可能只使用一個參數集中的參數,但不可以結合不同參數集的參數。如需如何使用參數集的詳細資訊,請參閱 Cmdlet Parameter Sets

New-SPProfileServiceApplication cmdlet 可新增及建立新的設定檔案服務應用程式,或建立設定檔服務的執行個體。

Parameters

參數 必要 類型 描述

ApplicationPool

必要

Microsoft.SharePoint.PowerShell.SPIisWebServiceApplicationPoolPipeBind

指定服務應用程式現有的 IIS 應用程式集區執行 Web 應用程式。

此類型必須是格式為 12345678-90ab-cdef-1234-567890bcdefgh 的有效 GUID;有效的應用程式集區名稱 (例如 AppPoolName1);或有效之 IISWebServiceApplicationPool 物件的執行個體。

Name

必要

System.String

指定新使用者設定檔服務應用程式的顯示名稱。此名稱必須是使用者設定檔服務應用程式在此伺服器陣列中的唯一名稱。名稱最長可包含 64 個字元。

此類型必須是有效的服務應用程式名稱,例如 UserProfileSvcApp1。

AssignmentCollection

選用

Microsoft.SharePoint.PowerShell.SPAssignmentCollection

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

注意

使用 Global 參數時,所有物件會包含在全域儲存區內。若未立即使用物件,或未使用 Stop-SPAssignment 命令處置物件,將會發生記憶體不足的狀況。

Confirm

選用

System.Management.Automation.SwitchParameter

執行命令之前,會先提示您進行確認。如需詳細資訊,請輸入下列命令:get-help about_commonparameters

MySiteHostLocation

選用

Microsoft.SharePoint.PowerShell.SPSitePipeBind

指定在建立「我的網站」所在的網站集合。

此類型必須是格式為 12345678-90ab-cdef-1234-567890bcdefgh 的有效 GUID;格式為 http://server_name 的有效 URL;或有效之 SPSite 物件的執行個體。

MySiteManagedPath

選用

System.String

指定個人網站建立所在的受管理路徑。

此類型必須是格式為 http://server_name 的有效 URL。

PartitionMode

選用

System.Management.Automation.SwitchParameter

指定服務應用程式需根據網站群組限制資料。設定 PartitionMode 參數並建立服務應用程式之後,就無法變更此值。

ProfileDBCredentials

選用

System.Management.Automation.PSCredential

指定安全性認證設定,例如此 cmdlet 所建立,用於連線至使用者設定檔資料庫的使用者名稱及密碼。

此類型必須是有效的 PSCredential 物件。

ProfileDBName

選用

System.String

指定使用者設定檔資料庫建立所在之資料庫的名稱。

ProfileDBServer

選用

System.String

指定使用者設定檔資料庫建立所在的資料庫。

此類型必須是有效的 SQL Server 資料庫名稱,例如 ProfileAppDB1。

ProfileSyncDBCredentials

選用

System.Management.Automation.PSCredential

指定安全性認證設定,例如 ProfileSyncDBName 參數所指定,用於連線至 Profile Sync 資料庫的使用者名稱及密碼。

此類型必須是有效的 PSCredential 物件。

ProfileDBFailoverServer

選用

System.String

使內容資料庫與結合 SQL Server 資料庫鏡像一起使用的特定容錯移轉伺服器產生關聯。伺服器名稱是必要值。

ProfileSyncDBName

選用

System.String

指定 Profile Sync 資料庫建立所在的資料庫。

此類型必須是有效的 SQL Server 資料庫名稱,例如 ProfileSyncAppDB1。

ProfileSyncDBServer

選用

System.String

指定 ProfileSyncDBName 參數中所指定用於主控 Profile Sync 資料庫的資料庫伺服器。

此類型必須是有效的 SQL Server 主機名稱,例如 SQLServerProfileSyncHost1。

ProfileSyncDBFailoverServer

選用

System.String

使 Profile Sync 資料庫與結合 SQL Server 資料庫鏡像一起使用的特定容錯移轉伺服器產生關聯。伺服器名稱是必要值。

SiteNamingConflictResolution

選用

System.String

指定要用來命名個人網站的格式。

使用下列其中一個整數值:

1   個人網站集合將根據沒有任何衝突解析的使用者名稱。例如,http://portal_site/location/username/

2   個人網站集合將使用網域名稱以具有衝突解析的使用者名稱為基礎。例如,.../username/ 或 .../domain_username/

3   個人網站集合將使用網域及使用者名稱來命名,以避免任何衝突。例如,http://portal_site/location/domain_username/

預設值為 1 (不解析衝突)。

SocialDBCredentials

選用

System.Management.Automation.PSCredential

各種安全性認證設定,包括此 cmdlet 所建立,用於連線至社交資料庫的使用者名稱及密碼。

此類型必須是有效的 PSCredential 物件。

SocialDBName

選用

System.String

指定 Social 資料庫建立所在的資料庫。

此類型必須是有效的 SQL Server 主機名稱,例如 SQLServerSocialHost1。

SocialDBServer

選用

System.String

指定 SocialDBName 所指定用於主控社交資料庫的資料庫伺服器。

此類型必須是有效的 SQL Server 主機名稱,例如 SQLServerSocialHost1。

SocialDBFailoverServer

選用

System.String

使 Social 資料庫與結合 SQL Server 資料庫鏡像一起使用的特定容錯移轉伺服器產生關聯。伺服器名稱是必要值。

SyncInstanceMachine

選用

Microsoft.SharePoint.PowerShell.SPServerPipeBind

指定 Profile Sync 資料庫所在的伺服器電腦。

此類型必須是有效的 GUID,如 12345678-90ab-cdef-1234-567890bcdefgh;格式為 208.77.188.166 的伺服器電腦 IP 位址;有效的 SQL Server 主機服務名稱 (例如 SQLServerHost1);或有效之 SPServer 物件的執行個體。

WhatIf

選用

System.Management.Automation.SwitchParameter

顯示訊息描述命令效果,而非描述命令執行的效果。如需詳細資訊,請輸入下列命令:get-help about_commonparameters

輸入類型

傳回類型

Example

----------------------範例-------------------------

$appPool = New-SPIisWebServiceApplicationPool -Name HostedAppPool -Account (Get-SPManagedAccount "contoso\AppPoolAccount")
New-SPProfileServiceApplication -Name PartitionedUserProfileApplication -PartitionMode -ApplicationPool $appPool

此範例會建立新的使用者設定檔服務應用程式。

See Also

Reference

Set-SPProfileServiceApplication