PowerShell を使用してコンテナーを管理する

適用対象: テナント管理者の使用 - SharePoint Embedded 管理者/ グローバル管理者

SharePoint Online 管理シェルを使用して、SharePoint Embedded アプリケーションとコンテナーの管理を自動化します。

PowerShell は、インベントリ、レポート、ライフサイクル操作、秘密度ラベルの更新、共有構成、アクセス許可の確認に役立ちます。

この記事では、サポートされている管理者コマンドレットと、より深い構文の詳細については、正規のコマンドレット参照へのリンクについて説明します。

重要

SharePoint Embedded コンテナー管理コマンドレットを実行する前に、最新バージョンのSharePoint Online 管理シェルを使用します。

開始する前に

これらの前提条件を確認します。

  • アカウントには、SharePoint Embedded Administrator ロールまたはグローバル管理者ロールがあります。
  • SharePoint Online 管理シェルを使用してテナントに接続できます。
  • テナント管理者 URL がわかっている。
  • アプリケーションまたはコンテナーの結果をフィルター処理するときに、所有するアプリケーション ID がわかっている。
  • コンテナーを削除する前に、ビジネスへの影響を理解します。

ロールの詳細については、「 SharePoint Embedded 管理者」を参照してください。

SharePoint Online 管理シェルをインストールする

SharePoint Online 管理シェルをインストールします。

[スタート] メニューから開くか、サポートされている PowerShell ホストを使用してモジュールを使用できます。

SharePoint Embedded コマンドレットを実行する前に、最新のシェルをインストールし、SharePoint Online に接続します。

接続の詳細については、「 Connect-SPOService」を参照してください。

SharePoint Online に接続する

テナント管理者エンドポイントに接続します。

Connect-SPOService -Url https://<tenant>-admin.sharepoint.com

<tenant>をテナント名に置き換えます。

必要な管理者ロールを持つアカウントでサインインします。

ヒント

organizationの特権アクセス ポリシーに従う専用の管理アカウントを使用します。

インベントリ SharePoint Embedded アプリケーション

テナントに登録されている SharePoint Embedded アプリケーションを一覧表示します。

Get-SPOApplication

特定の所有アプリケーションの詳細を表示します。

Get-SPOApplication -OwningApplicationId <OwningApplicationId>

コマンドの詳細については、「 Get-SPOApplication」を参照してください。

ゲスト アプリケーションのアクセス許可を表示する

SharePoint Embedded アプリケーションのゲスト アプリケーションのアクセス許可を表示します。

Get-SPOApplication -OwningApplicationId <OwningApplicationId> -ApplicationId <ApplicationId>

OwningApplicationId は、SharePoint Embedded 所有アプリケーションの ID です。 ApplicationId は、SharePoint Embedded アプリケーションにアクセスできるゲスト アプリケーション ID です。

アプリケーション管理コマンドレットは、Microsoft Loopには適用されません。

アプリケーション共有を構成する

テナント管理者を使用すると、アプリケーション レベルで外部共有機能を構成できます。

Set-SPOApplication -OwningApplicationId <OwningApplicationId> -SharingCapability <SharingCapability> -OverrideTenantSharingCapability <OverrideTenantSharingCapability>

SharingCapability では、次の値がサポートされています。

  • Disabled
  • ExistingExternalUserSharingOnly
  • ExternalUserSharingOnly
  • ExternalUserAndGuestSharing

OverrideTenantSharingCapability値は、$trueまたは$falseできます。 テナント共有の動作をオーバーライドする前に、テナント共有ポリシーを確認してください。

アクティブなコンテナーを一覧表示する

SharePoint Embedded アプリケーションのアクティブなコンテナーを一覧表示します。

Get-SPOContainer -OwningApplicationId <OwningApplicationId> | FT

OwningApplicationIdは、SharePoint Embedded アプリケーションの ID です。

コンテナー Microsoft Loop場合は、コンテナー管理コマンドレットで次の所有アプリ ID を使用します。

a187e399-0c36-4b98-8f04-1edc167a0996

コマンドの詳細については、「 Get-SPOContainer」を参照してください。

ストレージで並べ替えられたコンテナーを一覧表示する

コストまたは増加を調査するときに、ストレージ別にコンテナーを並べ替えます。

Get-SPOContainer -OwningApplicationId <OwningApplicationId> -SortByStorage <value> | FT

<value>にはAscendingまたはDescendingを使用します。

このビューを [使用状況、課金、コストの監視] と 共に使用して、高成長のアプリまたはコンテナーを見つけます。

コンテナーの詳細を取得する

コンテナー ID またはサイト URL で特定のコンテナーの詳細を表示します。

Get-SPOContainer -Identity <ContainerId>
Get-SPOContainer -Identity <SiteURL>

詳細な結果には、ストレージ、所有権の詳細、サイト URL、ラベル情報、所有者数が含まれます。

Microsoft Purview で一部のコンプライアンスコントロールを構成する場合は、サイト URL を使用します。

秘密度ラベルを設定または削除する

コンテナーの秘密度ラベルを設定します。

Set-SPOContainer -Identity <ContainerID> -SensitivityLabel <SensitivityLabel>

コンテナーから秘密度ラベルを削除します。

Set-SPOContainer -Identity <ContainerID> -RemoveLabel

コンプライアンス管理者と秘密度ラベルの変更を調整します。

コンプライアンス ガイダンスについては、「 セキュリティとコンプライアンスの制御を適用する」を参照してください。

コンテナー メンバーシップを管理する

Consuming-tenant 管理者は、コンテナーに対するユーザーのロールを直接追加、削除、または変更できます (2025 年 9 月)。

Add-SPOContainerUser -ContainerId <ContainerId> -LoginName <UserPrincipalName> -Role <Reader|Writer|Manager|Owner>
Set-SPOContainerUser -ContainerId <ContainerId> -LoginName <UserPrincipalName> -Role <Reader|Writer|Manager|Owner>
Remove-SPOContainerUser -ContainerId <ContainerId> -LoginName <UserPrincipalName>

コマンドの詳細については、「Add-SPOContainerUser」、「Set-SPOContainerUser」、「Remove-SPOContainerUser」を参照してください。

コンテナーを削除する

削除されたコンテナー コレクションにコンテナーを移動します。

Remove-SPOContainer -Identity <ContainerId>

コンテナーを削除すると、データの損失、リンクの破損、アプリケーションエラー、アクセス許可の問題が発生する可能性があります。

削除する前に、コンテナー所有者とアプリ所有者に通知します。

警告

コンテナーを削除すると、コンテナーを所有する SharePoint Embedded アプリケーションの使用が中断される可能性があります。

コマンドの詳細については、「 Remove-SPOContainer」を参照してください。

削除されたコンテナーを表示する

削除されたコンテナー コレクション内の削除されたコンテナーを一覧表示します。

Get-SPODeletedContainer

コマンドの詳細については、「 Get-SPODeletedContainer」を参照してください。

削除されたコンテナーを復元する

削除されたコンテナー コレクションから削除されたコンテナーを復元します。

Restore-SPODeletedContainer -Identity <ContainerId>

復元後、SharePoint 管理センターでコンテナーを検証し、アプリの所有者にアプリのテストを依頼します。

コンテナーを完全に削除する

復旧が不要になったときに、削除されたコンテナー コレクションからコンテナーを完全に削除します。

Remove-SPODeletedContainer -Identity <ContainerId>

コマンドの詳細については、「 Remove-SPODeletedContainer」を参照してください。

注意

完全削除を取り消すことはできません。 このコマンドを実行する前に、保持と法的要件を確認します。

ゲスト アプリケーションのアクセス許可を管理する

許可されている場合、管理者は SharePoint Embedded アプリケーションへのゲスト アプリケーション アクセスを追加、編集、削除できます。 このシナリオでは、 Set-SPOApplicationPermission を使用します。

Set-SPOApplicationPermission
   [[-OwningApplicationId] <OwningApplicationid>]
   [[-GuestApplicationId] <GuestApplicationId>]
   [[-PermissionAppOnly] <AppOnlyPermission>]
   [[-PermissionDelegated] <DelegatedPermission>]

コマンドの詳細については、「 Set-SPOApplicationPermission」を参照してください。

安全にスクリプトを作成する

以下の運用方法に従ってください。

  • ライフサイクルが変更される前にインベントリをエクスポートします。
  • 最初に読み取り専用コマンドを使用してフィルターをテストします。
  • 削除操作と復元操作には明示的なコンテナー ID を使用します。
  • 変更レコードのログ コマンド出力。
  • コンテナーを削除または復元する前に、アプリ所有者に通知します。
  • コストの決定を行う前に、ストレージが多いコンテナーを確認してください。
  • コンプライアンス管理者とラベルとコンプライアンスの変更を調整します。

関連コンテンツ

次の手順

使用量 、課金、コストの監視に関するページを参照してください。

  • Last updated on