Get-SPOContainer
傳回 SharePoint Embedded 應用程式中的一或多個容器。
語法
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>]
Description
Get-SPOContainer當與需要指定容器識別碼的參數配Identity對時，Cmdlet 會擷取處於使用中或封存狀態的個別容器詳細資料。 與參數搭配 OwningApplicationId 使用時，Cmdlet 會傳回與 SharePoint Embedded 應用程式相關聯之使用中容器的清單。 此外，當也與參數一起使用 ArchiveStatus 時，它會傳回指定為封存狀態的容器清單。
您必須是 SharePoint Embedded 系統管理員才能執行此 Cmdlet。
如需適用於 SharePoint Embedded 容器的 Windows PowerShell 權限和最新資訊，請參閱 SharePoint Embedded 容器管理命令介面簡介中的文件。
注意事項
您無法使用此 Cmdlet 擷取資源回收筒中的容器。
使用下列 OwningApplicationId 值來識別特定的 Microsoft 應用程式：
| 應用程式 | 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 會傳回容器的詳細屬性，以及相關聯的容器識別碼 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 會傳回屬於 SharePoint Embedded 應用程式且 OwningApplicationId 為 423poi45 的最近封存容器的表格式清單。
範例 10
Get-SPOContainer -Identity b!ISJs1WRro0y0EWgkUYcktDa0mE8zSlFEqFzqRn70Zwp1CEtDEBZgQICPkRbil_8U | Select InformationSegment
範例 10 會傳回與容器相關聯的。InformationSegment 若要使用此命令，您的租用戶必須已啟用 Microsoft 365 資訊屏障。 如需詳細資訊，請參閱瞭解 資訊屏障。
參數
-ArchiveStatus
適用對象：SharePoint Online
ArchiveStatus 參數可用來顯示處於封存不同階段的容器。 支援下列州：
- 已封存 – 顯示所有已封存狀態的容器。
- RecentlyArchived – 顯示處於「最近封存」狀態的容器。
- FullyArchived – 顯示處於 [完全封存] 狀態的容器。
- 正在重新啟用 — 顯示處於 [重新啟用] 狀態的容器。
- NotArchived – 顯示使用中的容器。
參數屬性
| 類型: | Microsoft.Online.SharePoint.TenantAdministration.SPContainerArchiveStatusFilterProperties |
| 預設值: | None |
| 接受的值: | NotArchived, FullyArchived, RecentlyArchived, Reactivating, Archived |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Archive
| Position: | 1 |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Identity
適用對象：SharePoint Online
使用此參數指定容器識別碼。
參數屬性
| 類型: | Microsoft.Online.SharePoint.PowerShell.SPOContainerPipeBind |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Identity
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-OwningApplicationId
適用對象：SharePoint Online
此參數會指定 SharePoint Embedded 應用程式的識別碼。 使用 Get-SPOApplication 命令來擷取 OwningApplicationId。
參數屬性
| 類型: | System.Guid |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
OwningApplicationId
| Position: | 0 |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
Sort
| Position: | 0 |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
Archive
| Position: | 0 |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Paged
適用對象：SharePoint Online
當指定 SharePoint Embedded 應用程式中有超過 200 個容器時，可以使用此參數。 使用 -Paged 將提供顯示接下來 200 個容器的分頁權杖。
參數屬性
| 類型: | System.Management.Automation.SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
OwningApplicationId
| Position: | 1 |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
Sort
| Position: | 1 |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
Archive
| Position: | 1 |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-PagingToken
適用對象：SharePoint Online
使用此參數來提供分頁權杖，以檢視剩餘的容器，如範例 4 所示。 如果沒有要顯示的容器，Cmdlet 輸出將會傳回訊息 End of containers view. 否則，請使用指定的分頁權杖來擷取下一個批次最多 200 個容器。 若要顯示下一組已封存的容器， -ArchiveStatus 必須同時使用參數和此參數。
參數屬性
| 類型: | System.String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
OwningApplicationId
| Position: | 2 |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
Sort
| Position: | 2 |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
Archive
| Position: | 2 |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-SortByStorage
適用對象：SharePoint Online
當您需要查看按儲存體排序的容器清單時，可以使用此參數。
參數屬性
| 類型: | Microsoft.Online.SharePoint.TenantManagement.SortOrder |
| 預設值: | None |
| 接受的值: | Ascending, Descending |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Sort
| Position: | 1 |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
CommonParameters
此 Cmdlet 支援常見參數： -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊，請參閱 about_CommonParameters。