New-SPAccessServiceApplication

在 SharePoint Server 中创建 Access Services 应用程序的新实例。

语法

Default (默认值)

New-SPAccessServiceApplication
    [-Name <String>]
    -ApplicationPool <SPIisWebServiceApplicationPoolPipeBind>
    [-AssignmentCollection <SPAssignmentCollection>]
    [-CacheTimeout <Int32>]
    [-ColumnsMax <Int32>]
    [-Confirm]
    [-Default]
    [-NonRemotableQueriesAllowed]
    [-OrderByMax <Int32>]
    [-OuterJoinsAllowed]
    [-OutputCalculatedColumnsMax <Int32>]
    [-PrivateBytesMax <Int32>]
    [-RecordsInTableMax <Int32>]
    [-RequestDurationMax <Int32>]
    [-RowsMax <Int32>]
    [-SessionMemoryMax <Int32>]
    [-SessionsPerAnonymousUserMax <Int32>]
    [-SessionsPerUserMax <Int32>]
    [-SourcesMax <Int32>]
    [-TemplateSizeMax <Int32>]
    [-WhatIf]
    [-ApplicationLogSizeMax <Int32>]
    [<CommonParameters>]

说明

New-SPAccessServiceApplication cmdlet 在 SharePoint Server 2010 和 SharePoint Server 2013 中创建 Access Services 应用程序的新实例。 创建新 Access Services 应用程序后,使用 Set-SPAccessServiceApplication cmdlet 可修改它的全局设置。

有关适用于 SharePoint 产品的 Windows PowerShell 的权限和最新信息,请参阅 SharePoint Server cmdlet

示例

示例 1

New-SPAccessServiceApplication -Name "MyAccessService" -SPIisWebServiceApplicationPool MyAppPool

此示例会为在名为 MyAppPool 的应用程序池下运行的名为 MyAccessService 的 Access Services 创建一个新实例。

示例 2

New-SPAccessServiceApplication -Name "MyAccessService" -SPIisWebServiceApplicationPool MyAppPool -SessionsPerUserMax 25

此示例会为在名为 MyAppPool 的应用程序池下运行的名为 MyAccessService 的 Access Services 创建一个新实例,该实例允许每名用户在每台运行 Access Services 的后端应用程序服务器计算机上最多使用 25 个会话。

参数

-ApplicationLogSizeMax

适用:SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019

指定 Access Services 应用程序日志列表的最大记录数。 有效值:-1 至 maxint。 0 表示不允许任何记录。 默认值为 3000。

参数属性

类型:Int32
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-ApplicationPool

适用:SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019

指定要针对新的 Access Services 应用程序在其中运行 Web 服务的现有 Internet Information Services (IIS) 应用程序池。

键入的值必须是 SPIisWebServiceApplicationPool 对象的有效实例。

参数属性

类型:SPIisWebServiceApplicationPoolPipeBind
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:True
来自管道的值:True
来自管道的值(按属性名称):False
来自剩余参数的值:False

-AssignmentCollection

适用:SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019

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

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

参数属性

类型:SPAssignmentCollection
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:True
来自管道的值(按属性名称):False
来自剩余参数的值:False

-CacheTimeout

适用:SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019

指定数据缓存在没有用户活动的情况下在 Access Services 中保持活动状态的秒数。 有效值包括:-1,缓存永不超时;1 到 2073600,缓存保持活动状态的时间为 1 秒到 24 天。

键入的值必须为整数 -1,或介于 1 到 2073600(24 天)之间的某个整数。 默认值为 300。

参数属性

类型:Int32
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-ColumnsMax

适用:SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019

指定查询中所涉及的列表或查询的输出可以包含的最大列数。 默认值为 30。

键入的值必须为介于 1 到 255 之间的某个整数

参数属性

类型:Int32
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Confirm

适用:SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019

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

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False
别名:cf

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Default

适用:SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019

通过将服务应用程序的代理添加到场的默认代理列表,指定服务应用程序与 Web 应用程序相关联。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Name

适用:SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019

指定要创建的 Access Services 应用程序的显示名称。 该名称最多可以包含 128 个字符,并且可以包含逗号 (,)、等号 (=) 或冒号 (:) 字符,但要用引号将这些字符引起来。

键入的值必须是 Access Services 应用程序的有效名称,例如,AccessSrvApp1。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-NonRemotableQueriesAllowed

适用:SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019

指定可以运行无法远程传输到数据库层的查询。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-OrderByMax

适用:SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019

指定查询中 Order By 子句的最大数目。 默认值为 4。

键入的值必须为 1 到 8 之间的整数。

参数属性

类型:Int32
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-OuterJoinsAllowed

适用:SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019

指定支持左外部和右外部联接。 始终支持内联。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-OutputCalculatedColumnsMax

适用:SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019

指定可作为查询的一部分包括在输出中的计算列的最大数量。 将不包括基础列表中的计算列。 默认值为 10。

键入的值必须为 1 到 32 之间的整数。

参数属性

类型:Int32
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-PrivateBytesMax

适用:SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019

指定访问服务可以使用的最大专用字节 (MB) 。 设置为 -1 时,Access Services 默认为计算机上的物理内存的 75%。 有效值为 -1 (没有) 限制,并且从 1 到任何正整数。默认值为 -1。

参数属性

类型:Int32
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-RecordsInTableMax

适用:SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019

指定 Access Services 应用程序中的表所允许的最大记录数。 有效值包括:-1(无限制)以及 1 到任何正整数。 默认值为 500000。

键入的值必须为整数 -1,或介于 1 到 MaxInt 之间的某个整数。

参数属性

类型:Int32
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-RequestDurationMax

适用:SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019

指定执行作的请求在请求超时之前可以使用的最大秒数。有效值包括:-1,无限制,1 到 2073600,缓存保持活动 1 秒到 24 天。 默认值为 30。

键入的值必须为整数 -1,或介于 1 到 2073600(24 天)之间的某个整数

参数属性

类型:Int32
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-RowsMax

适用:SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019

指定查询中所涉及的列表或查询的输出可以包含的最大行数。 默认值为 50000。

键入的值必须为 1 到 200000 之间的整数。

参数属性

类型:Int32
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-SessionMemoryMax

适用:SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019

指定各个会话允许的最大大小(以 MB 为单位)。 有效值包括 0(禁用属性)以及 1 到 4095。 默认值为 64。

键入的值必须为整数 0,或介于 1 到 4095 之间的某个整数。

参数属性

类型:Int32
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-SessionsPerAnonymousUserMax

适用:SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019

指定每个用户的最大允许会话数。 如果达到此最大值,在启动新会话时,将会删除最旧的会话。 有效值包括:-1(无限制)以及 1 到任何正整数。 默认值为 10。

键入的值必须为整数 -1,或介于 1 到 MaxInt 之间的某个整数。

参数属性

类型:Int32
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-SessionsPerUserMax

适用:SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019

指定每个用户的最大允许会话数。 如果达到此最大值,在启动新会话时,将会删除最旧的会话。 有效值包括:-1(无限制)以及 1 到任何正整数。 默认值为 10。

键入的值必须为整数 -1,或介于 1 到 MaxInt 之间的某个整数。

参数属性

类型:Int32
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-SourcesMax

适用:SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019

指定可以作为查询输入一次使用的最大列表数。 默认值为 8。

键入的值必须为 1 到 20 之间的整数。

参数属性

类型:Int32
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-TemplateSizeMax

适用:SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019

) 上传到解决方案库中的 Access 模板 (.accdt 文件允许的最大允许大小(以兆字节为单位)。 有效值包括:-1(无限制)以及 1 到任何正整数。

参数属性

类型:Int32
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-WhatIf

适用:SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019

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

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False
别名:无线

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

CommonParameters

此 cmdlet 支持通用参数:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息,请参阅 about_CommonParameters