New-SPSubscriptionSettingsServiceApplication

适用于: SharePoint Foundation 2013, SharePoint Server 2013

上一次修改主题: 2015-03-09

创建新的订阅设置服务应用程序。

Syntax

New-SPSubscriptionSettingsServiceApplication -ApplicationPool <SPIisWebServiceApplicationPoolPipeBind> [-AssignmentCollection <SPAssignmentCollection>] [-Confirm [<SwitchParameter>]] [-DatabaseCredentials <PSCredential>] [-DatabaseName <String>] [-DatabaseServer <String>] [-FailoverDatabaseServer <String>] [-Name <String>] [-WhatIf [<SwitchParameter>]]

详细说明

使用 New-SPSubscriptionSettingsServiceApplication cmdlet 可以创建订阅设置服务应用程序,该应用程序可用于在单一网站订阅中存储跨所有网站集共享的设置。此 cmdlet 仅在以下环境下使用:使用网站订阅来委托用于在单一网站订阅中存储跨所有网站集共享的设置的管理服务或分区服务。此 cmdlet 仅在网站订阅用于委托管理服务或分区服务的环境下使用。

Parameters

参数 必需 类型 说明

ApplicationPool

必需

Microsoft.SharePoint.PowerShell.SPIisWebServiceApplicationPoolPipeBind

指定要用于新订阅设置应用程序的 IIS 应用程序池。

该类型必须是有效的 GUID(格式为 12345678-90ab-cdef-1234-567890bcdefgh);是应用程序池的有效名称(例如 AppPoolName1);或者是有效 IISWebServiceApplicationPool 对象的实例。

AssignmentCollection

可选

Microsoft.SharePoint.PowerShell.SPAssignmentCollection

管理对象以便正确进行处理。使用 SPWebSPSite 等对象可能会耗用大量内存,而且在 Windows PowerShell 脚本中使用这些对象需要正确管理内存。通过使用 SPAssignment 对象,可以将对象分配给变量,然后在不需要这些对象时对它们进行处理,以释放内存。在使用 SPWebSPSiteSPSiteAdministration 对象时,如果不使用分配集合或 Global 参数,则会自动处理这些对象。

注意Note
在使用 Global 参数时,所有对象均包含在全局存储中。如果未立即使用对象,或未通过使用 Stop-SPAssignment 命令来处理对象,则可能会发生内存不足的情况。

Confirm

可选

System.Management.Automation.SwitchParameter

在执行命令之前提示您确认。有关详细信息,请键入以下命令:get-help about_commonparameters

DatabaseCredentials

可选

System.Management.Automation.PSCredential

指定包含要用于数据库 SQL Server 身份验证的用户名和密码的 PSCredential 对象。

该类型必须是有效的 PSCredential 对象。

DatabaseName

可选

System.String

指定订阅设置数据库的名称。

如果未提供,将生成一个订阅设置数据库。

该类型必须为 SQL Server 数据库的有效名称,例如 SubscriptionSettingsApp1。

DatabaseServer

可选

Microsoft.SharePoint.PowerShell.SPServerPipeBind

指定 DatabaseName 参数中指定的数据库的主机 SQL Server 实例名称。如果未提供,将使用默认数据库服务器

该类型必须为有效 SQL Server 实例名称,例如 SQLServerHost1。

该类型必须为 SQL Server 数据库的有效名称,例如 SubscriptionSettingsApp1。

FailoverDatabaseServer

可选

Microsoft.SharePoint.PowerShell.SPServerPipeBind

为故障转移数据库服务器指定主机 SQL Server 实例的名称。

该类型必须为有效 SQL Server 实例名称,例如 SQLServerHost1。

Name

可选

System.String

指定新订阅设置服务的友好名称。

该类型必须为订阅设置服务应用程序的有效名称,例如 SubscriptionSettingsApp1。

WhatIf

可选

System.Management.Automation.SwitchParameter

显示一条描述命令作用的消息,而不执行命令。有关详细信息,请键入以下命令:get-help about_commonparameters

输入类型

返回类型

Example

---------------示例---------------

$AppPool = New-SPServiceApplicationPool -Name SettingsServiceAppPool -Account (Get-SPManagedAccount DOMAIN\jdoe)

$App = New-SPSubscriptionSettingsServiceApplication -ApplicationPool $appPool -Name SettingsServiceApp -DatabaseName SettingsServiceDB

$proxy = New-SPSubscriptionSettingsServiceApplicationProxy -ServiceApplication $App

Get-SPServiceInstance | where{$_.TypeName -eq "Microsoft SharePoint Foundation Subscription Settings Service"} | Start-SPServiceInstance

此示例创建应用程序池、新订阅设置服务应用程序、订阅设置服务应用程序代理,并在本地计算机上启动服务实例。此示例假设 DOMAIN\jdoe 的管理帐户已存在。

See Also

Reference

Set-SPSubscriptionSettingsServiceApplication
New-SPSubscriptionSettingsServiceApplicationProxy