Register-SPAppPrincipal

允许本地管理员注册应用主体。

语法

Default (默认值)

Register-SPAppPrincipal
    -DisplayName <String>
    -NameIdentifier <String>
    -Site <SPWebPipeBind>
    [-AssignmentCollection <SPAssignmentCollection>]
    [<CommonParameters>]

说明

Register-SPAppPrincipal使用 cmdlet 允许本地服务器场管理员注册应用主体管理服务。

有关 SharePoint 产品Windows PowerShell的权限和最新信息,请参阅 中的https://go.microsoft.com/fwlink/p/?LinkId=251831(https://go.microsoft.com/fwlink/p/?LinkId=251831)联机文档。

示例

$site = Get-SPSite "https://<urlofsite>"
Register-SPAppPrincipal -site $site.RootWeb -NameIdentifier "00000003-0000-0ff1-ce00-000000000000@f686d426-8d16-42db-81b7-cb578e110ccd" -DisplayName "Contoso"

此示例注册名为 Contoso 的应用主体。

参数

-AssignmentCollection

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

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

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

参数属性

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

参数集

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

-DisplayName

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

指定要所注册的应用程序主体使用的友好名称。

参数属性

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

参数集

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

-NameIdentifier

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

指定需要添加到应用管理服务的应用主体的名称标识符。

参数属性

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

参数集

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

-Site

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

{{填写网站说明}}

参数属性

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

参数集

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

CommonParameters

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