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

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

SharePoint PowerShell を使用して、アプリ用の SharePoint Embedded コンテナーの種類を作成します。コンテナーの種類ごとに、1 つの Microsoft Entra アプリケーションに対応します。

開始する前に

以下があることを確認してください。

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

重要

コンテナータイプを作成するときに請求方法を選択します。作成後に請求方法を変更することはできません。

標準の請求アプリを作成する

アプリを所有する organization が SharePoint Embedded の使用料を支払う場合は、標準課金を使用します。

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

Azure サブスクリプション、リソースグループ、リージョンを割り当てて、Standard コンテナーの種類の課金を設定します。

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 アクセスを確認します。サインインしたアカウントには、リンクされた Azure サブスクリプションスコープでのMicrosoft.Resources/subscriptions/readアクセス許可が必要です。 Azure 閲覧者、共同作成者、所有者ロールには、このアクセス許可が含まれます。

この Azure アクセス許可がない場合、コマンドレットはコンテナーの種類を返します。ただし、課金の詳細は省略され、アクセス許可メッセージが表示されます。 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 アプリをインストールします。

Last updated on 2026-08-25