Get-SPOContainer
SharePoint Embedded アプリケーション内の 1 つ以上のコンテナーを返します。
構文
All (既定)
Get-SPOContainer
[[-PagingToken] <String>]
[[-SortByStorage] <SortOrder>]
[[-ArchiveStatus] <SPContainerArchiveStatusFilterProperties>]
[-Identity <SPOContainerPipeBind>]
[-Paged]
[-ProgressAction <ActionPreference>]
[<CommonParameters>]
OwningApplicationId
Get-SPOContainer
[-OwningApplicationId] <Guid>
[[-PagingToken] <String>]
[-Paged]
[-ProgressAction <ActionPreference>]
[<CommonParameters>]
Sort
Get-SPOContainer
[-OwningApplicationId] <Guid>
[[-PagingToken] <String>]
[-SortByStorage] <SortOrder>
[-Paged]
[-ProgressAction <ActionPreference>]
[<CommonParameters>]
Archive
Get-SPOContainer
[-OwningApplicationId] <Guid>
[[-PagingToken] <String>]
[[-SortByStorage] <SortOrder>]
[-ArchiveStatus] <SPContainerArchiveStatusFilterProperties>
[-Paged]
[-ProgressAction <ActionPreference>]
[<CommonParameters>]
Identity
Get-SPOContainer
-Identity <SPOContainerPipeBind>
[-ProgressAction <ActionPreference>]
[<CommonParameters>]
説明
Get-SPOContainer コマンドレットは、コンテナー ID を指定する必要がある Identity パラメーターと組み合わせて、アクティブ状態またはアーカイブ状態の個々のコンテナーの詳細を取得します。
OwningApplicationId パラメーターと共に使用すると、コマンドレットは SharePoint Embedded アプリケーションに関連付けられているアクティブなコンテナーのリストを返します。 さらに、 ArchiveStatus パラメーターと共に使用すると、指定したとおりにアーカイブされた状態のコンテナーのリストが返されます。
このコマンドレットを実行するには、SharePoint Embedded 管理者である必要があります。
SharePoint 埋め込みコンテナー用の Windows PowerShell のアクセス許可と最新の情報については、「SharePoint 埋め込みコンテナー管理シェルの概要」のドキュメントを参照してください。
注:
このコマンドレットを使用して、ごみ箱内のコンテナーを取得することはできません。
特定の Microsoft アプリケーションを識別するには、次の OwningApplicationId 値を使用します。
| アプリケーション | OwningApplicationId |
|---|---|
| Microsoft 宣言型エージェント | e8be65d6-d430-4289-a665-51bf2a194bda |
| Microsoft Designer | 5e2795e3-ce8c-4cfb-b302-35fe5cd01597 |
| Microsoft Loop | a187e399-0c36-4b98-8f04-1edc167a0996 |
| Microsoft Outlook ニュースレター | 155d75a8-799c-4ad4-ae3f-0084ccced5fa |
| Microsoft Teams イベント ビデオ オンデマンド | 7fc21101-d09b-4343-8eb3-21187e0431a4 |
例
例 1
Get-SPOContainer
例 1 では、テナント内のすべてのコンテナーの詳細が返されます。
例 2
Get-SPOContainer -Identity b!ISJs1WRro0y0EWgkUYcktDa0mE8zSlFEqFzqRn70Zwp1CEtDEBZgQICPkRbil_8U
例 2 では、関連するコンテナー ID b! を使用して、コンテナーの詳細なプロパティが返されます。ISJs1WRro0y0EWgkUYcktDa0mE8zSlFEqFzqRn70Zwp1CEtDEBZgQICPkRbil_8U。
例 3
Get-SPOContainer -OwningApplicationId 2ce03211-353e-45d7-b487-8ac6981332cf | ft
例 3 では、SharePoint Embedded アプリケーションで作成されたコンテナーの表形式の一覧 ( OwningApplicationId が 2ce03211-353e-45d7-b487-8ac6981332cf) が返されます。
例 4
Get-SPOContainer -OwningApplicationId 2ce03211-353e-45d7-b487-8ac6981332cf -Paged | ft
例 4 では、 -Paged コマンドを使用してページング トークンを取得します。
例 5
Get-SPOContainer -OwningApplicationId 2ce03211-353e-45d7-b487-8ac6981332cf -Paged -PagingToken <zacad> | ft
例 5 では、 -PagingToken パラメーターと -Paged パラメーターを使用して、例 3 で表示されなかったコンテナーをさらに表示しています。
例 6
Get-SPOContainer -OwningApplicationId 2ce03211-353e-45d7-b487-8ac6981332cf -SortByStorage Ascending
例 6 は、アプリケーションに属するコンテナーをストレージの昇順で並べ替えて表示しています。
例 7
Get-SPOContainer -OwningApplicationId 2ce03211-353e-45d7-b487-8ac6981332cf -SortByStorage Ascending -Paged
例 7 は、アプリケーションに属するコンテナのページ ビューを、ストレージの昇順で並べ替えて表示しています。
例 8
Get-SPOContainer -OwningApplicationId 2ce03211-353e-45d7-b487-8ac6981332cf -SortByStorage Ascending -Paged -PagingToken <zacad>
例 8 は、アプリケーションに属するコンテナーのページ ビューの次のリストを、ストレージの昇順で並べ替えて表示しています。
例 9
Get-SPOContainer -OwningApplicationId 2ce03211-353e-45d7-b487-8ac6981332cf -ArchiveStatus RecentlyArchived | ft
例 9 では、OwningApplicationId が 423poi45 の SharePoint Embedded アプリケーションに属する、最近アーカイブされたコンテナーの表形式のリストが返されます。
例 10
Get-SPOContainer -Identity b!ISJs1WRro0y0EWgkUYcktDa0mE8zSlFEqFzqRn70Zwp1CEtDEBZgQICPkRbil_8U | Select InformationSegment
例 10 では、コンテナーに関連付けられている InformationSegment が返されます。 このコマンドを使用するには、テナントで Microsoft 365 Information Barriers が有効になっている必要があります。 詳細については、「 情報バリアについて」を参照してください。
パラメーター
-ArchiveStatus
適用対象: SharePoint Online
ArchiveStatus パラメーターは、アーカイブのさまざまな段階にあるコンテナーを表示するために使用されます。 次の状態がサポートされています。
- アーカイブ済み - アーカイブされたすべての状態でコンテナを表示します。
- 最近アーカイブ済み – 「最近アーカイブ」状態のコンテナーを表示します。
- FullyArchived – 「完全にアーカイブ」状態のコンテナーを表示します。
- 再アクティブ化中 – 「再アクティブ化中」状態のコンテナーを表示します。
- NotArchived - アクティブなコンテナーを表示します。
パラメーターのプロパティ
| 型: | Microsoft.Online.SharePoint.TenantAdministration.SPContainerArchiveStatusFilterProperties |
| 規定値: | None |
| 指定可能な値: | NotArchived, FullyArchived, RecentlyArchived, Reactivating, Archived |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
Archive
| 配置: | 1 |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Identity
適用対象: SharePoint Online
このパラメーターを使用して、コンテナー ID を指定します。
パラメーターのプロパティ
| 型: | Microsoft.Online.SharePoint.PowerShell.SPOContainerPipeBind |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
Identity
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-OwningApplicationId
適用対象: SharePoint Online
このパラメーターは、SharePoint 埋め込みアプリケーションの ID を指定します。
Get-SPOApplication コマンドを使用して、OwningApplicationId を取得します。
パラメーターのプロパティ
| 型: | System.Guid |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
OwningApplicationId
| 配置: | 0 |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
Sort
| 配置: | 0 |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
Archive
| 配置: | 0 |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Paged
適用対象: SharePoint Online
このパラメーターは、特定の SharePoint Embedded アプリケーションに 200 を超えるコンテナがある場合に使用できます。
-Paged を使用すると、次の 200 個のコンテナーを表示するページング トークンが提供されます。
パラメーターのプロパティ
| 型: | System.Management.Automation.SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
OwningApplicationId
| 配置: | 1 |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
Sort
| 配置: | 1 |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
Archive
| 配置: | 1 |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-PagingToken
適用対象: SharePoint Online
このパラメーターを使用して、残りのコンテナーを表示するページング トークンを指定します (例 4 参照)。 表示するコンテナがない場合は、コマンドレットの出力により次のメッセージが返されます End of containers view. それ以外の場合は、指定されたページング トークンを使用して、最大 200 個のコンテナーの次のバッチを取得します。 アーカイブされたコンテナーの次のセットを表示するには、 -ArchiveStatus パラメーターをこのパラメーターと一緒に使用する必要があります。
パラメーターのプロパティ
| 型: | System.String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
OwningApplicationId
| 配置: | 2 |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
Sort
| 配置: | 2 |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
Archive
| 配置: | 2 |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-SortByStorage
適用対象: SharePoint Online
このパラメーターは、ストレージで並べ替えられたコンテナーのリストを表示する必要がある場合に使用できます。
パラメーターのプロパティ
| 型: | Microsoft.Online.SharePoint.TenantManagement.SortOrder |
| 規定値: | None |
| 指定可能な値: | Ascending, Descending |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
Sort
| 配置: | 1 |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットは、共通パラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable をサポートします。 詳細については、「about_CommonParameters」を参照してください。