使用 PowerShell 创建应用

适用于: 开发人员租户管理员 - SharePoint Embedded 管理员/全局管理员

使用 SharePoint PowerShell 为应用创建 SharePoint Embedded 容器类型。 每个容器类型对应到一个 Microsoft Entra 应用程序。

开始之前

确保你有:

  • SharePoint Embedded 管理员或全局管理员角色。
  • 最新的 SharePoint Online 命令行管理程序。
  • 拥有容器类型的 Microsoft Entra 应用程序 ID。
  • 对于标准计费设置、Azure 订阅的所有者或参与者权限。

重要

在创建容器类型时选择计费方式。 创建后,无法更改计费方式。

创建标准计费应用

当拥有该应用的组织支付 SharePoint Embedded 使用费用时,请使用标准计费。

New-SPOContainerType -ContainerTypeName <ContainerTypeName> -OwningApplicationId <OwningApplicationId>

通过分配 Azure 订阅、资源组和区域来设置标准容器类型的计费。

Add-SPOContainerTypeBilling -ContainerTypeId <ContainerTypeId> -AzureSubscriptionId <AzureSubscriptionId> -ResourceGroup <ResourceGroup> -Region <Region>

创建直通计费应用

当使用租户支付 SharePoint Embedded 使用量时,使用直通计费。

New-SPOContainerType -IsPassThroughBilling -ContainerTypeName <ContainerTypeName> -OwningApplicationId <OwningApplicationId>

对于传递计费,使用租户管理员必须设置 Microsoft 365 即用即付服务,然后用户可以访问该应用。 有关详细信息,请参阅 在 Microsoft 365 管理中心设置计费

创建试用应用

使用试用版应用进行评估和概念验证工作。

New-SPOContainerType -TrialContainerType -ContainerTypeName <ContainerTypeName> -OwningApplicationId <OwningApplicationId>

试用版应用的有效期为 30 天。

查看应用

列出在拥有租户中创建的 SharePoint Embedded 应用。

Get-SPOContainerType
Get-SPOContainerType -ContainerTypeId <ContainerTypeId>

Get-SPOContainerType在显示标准计费容器类型的计费订阅、资源组和区域之前检查 Azure 访问权限。 已登录帐户需要Microsoft.Resources/subscriptions/read链接的 Azure 订阅范围的权限。 Azure 读取者、参与者和所有者角色包括此权限。

如果没有此 Azure 权限,cmdlet 仍会返回容器类型。 但是,它省略了计费详细信息并显示权限消息。 SharePoint Embedded 管理员和全局管理员角色不授予对 Azure 订阅的访问权限。

读取者访问权限足以查看计费详细信息。 需要所有者或参与者访问权限才能添加或更改计费关系。

更新应用属性

更新支持的容器类型属性。

Set-SPOContainerType -ContainerTypeId <ContainerTypeId>
                     [-ContainerTypeName <ContainerTypeName>]
                     [-WhatIf] [-Confirm]

配置应用行为

配置支持的容器类型设置,例如可发现性和共享限制。

Set-SPOContainerTypeConfiguration -ContainerTypeId <ContainerTypeId> -DiscoverabilityDisabled $true
Set-SPOContainerTypeConfiguration -ContainerTypeId <ContainerTypeId> -SharingRestricted $true

查看当前配置。

Get-SPOContainerTypeConfiguration -ContainerTypeId <ContainerTypeId>

后续步骤

在租户中安装应用: 安装 SharePoint Embedded 应用