PowerShell を使用してアプリを作成する

適用対象: 所有テナント管理者 — SharePoint Embedded 管理者 / グローバル管理者

SharePoint PowerShell を使用して、アプリ用の SharePoint Embedded コンテナーの種類を作成します。 各コンテナーの種類は、1 つのMicrosoft Entra アプリケーションに関連付けられています。

開始する前に

次の情報があることを確認します。

  • SharePoint 埋め込み管理者またはグローバル管理者ロール。
  • 最新のSharePoint Online 管理シェル。
  • コンテナーの種類を所有するMicrosoft Entraアプリケーション ID。
  • Azure サブスクリプションに対する標準の課金設定、所有者または共同作成者のアクセス許可の場合。

重要

コンテナーの種類を作成するときに課金方法を選択します。 作成後に課金方法を変更することはできません。

標準の課金対象アプリを作成する

アプリを所有するorganizationが 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>

アプリのプロパティを更新する

サポートされているコンテナーの種類のプロパティを更新します。

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 アプリをインストールします。