Get-SPOContainer
SharePoint Embedded アプリケーション内の 1 つ以上のコンテナーを返します。
構文
Get-SPOContainer
-Identity <SPOContainerPipeBind>
[<CommonParameters>]
Get-SPOContainer
[-OwningApplicationId] <Guid>
[-Paged]
[[-PagingToken] <String>]
[<CommonParameters>]
Get-SPOContainer
[-OwningApplicationId] <Guid>
[-Paged]
[[-PagingToken] <String>]
[-SortByStorage] <SortOrder>
[<CommonParameters>]
Get-SPOContainer
[-OwningApplicationId] <Guid>
[-Paged]
[[-PagingToken] <String>]
[[-SortByStorage] <SortOrder>]
[-ArchiveStatus] <SPContainerArchiveStatusFilterProperties>
[<CommonParameters>]
説明
Get-SPOContainer
コマンドレットは、コンテナー ID を指定する必要がある Identity
パラメーターとペアになっている場合、アクティブまたはアーカイブ状態の個々のコンテナーの詳細を取得します。
OwningApplicationId
パラメーターと共に使用すると、コマンドレットは SharePoint Embedded アプリケーションに関連付けられているアクティブなコンテナーの一覧を返します。 さらに、 ArchiveStatus
パラメーターでも使用すると、指定したアーカイブ状態のコンテナーの一覧が返されます。
このコマンドレットを実行するには、SharePoint Embedded 管理者である必要があります。
SharePoint 埋め込みコンテナーのWindows PowerShellに関するアクセス許可と最新の情報については、「SharePoint 埋め込みコンテナー管理シェルの概要」のドキュメントを参照してください。
注:
ごみ箱内のコンテナーは、 Get-SPOContainer
コマンドレットを使用して取得されません。
Microsoft Loopの OwningApplicationId がa187e399-0c36-4b98-8f04-1edc167a0996
。
Microsoft Designerの OwningApplicationId が5e2795e3-ce8c-4cfb-b302-35fe5cd01597
。
例
例 1
Get-SPOContainer -Identity b66f5b2e
例 1 は、関連付けられたコンテナー ID b66f5b2e を持つコンテナーの詳細なプロパティを返します。
例 2
Get-SPOContainer -OwningApplicationId 423poi45 | ft
例 2 は、SharePoint Embedded アプリケーションの下に作成されたコンテナーの表形式の一覧を、423poi45
のOwningApplicationId
と共に返します。
例 3
Get-SPOContainer -OwningApplicationId 423poi45 -Paged | ft
例 3 では、 -Paged
コマンドを使用してページング トークンを取得します。
例 4
Get-SPOContainer -OwningApplicationId 423poi45 -Paged -PagingToken <zacad> | ft
例 4 では、 -PagingToken
パラメーターと -Paged
パラメーターを使用して、例 3 に表示されなかったコンテナーをさらに表示します。
例 5
Get-SPOContainer -OwningApplicationId 423poi45 -SortByStorage Ascending
例 5 は、アプリケーションに属するコンテナーをストレージの昇順で並べ替えて表示します。
例 6
Get-SPOContainer -OwningApplicationId 423poi45 -SortByStorage Ascending -Paged
例 6 は、アプリケーションに属するコンテナーのページ ビューを、ストレージの昇順で並べ替えて表示します。
例 7
Get-SPOContainer -OwningApplicationId 423poi45-as -SortByStorage Ascending -Paged -PagingToken <zacad>
例 7 は、アプリケーションに属するコンテナーのページ ビューの次の一覧を、ストレージの昇順で並べ替えて表示します。
例 8
Get-SPOContainer -OwningApplicationId 423poi45 -ArchiveStatus RecentlyArchived | ft
例 8 は、OwningApplicationId が 423poi45 の SharePoint Embedded アプリケーションに属する最近アーカイブされたコンテナーの表形式の一覧を返します。
パラメーター
-ArchiveStatus
ArchiveStatus パラメーターは、アーカイブのさまざまな段階でコンテナーを表示するために使用されます。 次の状態がサポートされています。
• アーカイブ済み - アーカイブされたすべての状態のコンテナーを表示します。
• RecentlyArchived - "最近アーカイブされた" 状態のコンテナーを表示します。
• 完全アーカイブ - "完全にアーカイブされた" 状態のコンテナーを表示します。
• リアクティブ化 - "再アクティブ化" 状態のコンテナーを表示します。
• NotArchived - アクティブなコンテナーを表示します
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | SharePoint Online |
-Identity
このパラメーターを使用して、コンテナー ID を指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | SharePoint Online |
-OwningApplicationId
このパラメーターは、SharePoint Embedded アプリケーションの ID を指定します。
Get-SPOApplication
コマンドを使用して、OwningApplicationId を取得します。
型: | String |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | SharePoint Online |
-Paged
このパラメーターは、特定の SharePoint Embedded アプリケーションに 200 を超えるコンテナーがある場合に使用できます。
-Paged
を使用すると、次の 200 個のコンテナーを表示するページング トークンが提供されます。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | SharePoint Online |
-PagingToken
このパラメーターを使用して、例 4 に示すように、残りのコンテナーを表示するページング トークンを指定します。 表示するコンテナーがそれ以上ない場合、コマンドレットの出力はメッセージ End of containers view.
返します。それ以外の場合は、指定されたページング トークンを使用して、最大 200 個のコンテナーの次のバッチを取得します。 アーカイブされたコンテナーの次のセットを表示するには、パラメーター -ArchiveStatus
このパラメーターと共に使用する必要があります。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | SharePoint Online |
-SortByStorage
このパラメーターは、コンテナーの一覧をストレージ別に並べ替えて表示する必要がある場合に使用できます。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | SharePoint Online |