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 Cmdlet 會在與參數配Identity對時擷取個別容器的詳細數據，無論是處於作用中或封存狀態，都需要指定容器識別碼。 與參數搭配 OwningApplicationId 使用時，Cmdlet 會傳回與 SharePoint Embedded 應用程式相關聯的作用中容器清單。 此外，當也與參數搭配 ArchiveStatus 使用時，它會傳回處於已封存狀態的容器清單，如指定所示。
您必須是 SharePoint Embedded 系統管理員，才能執行此 Cmdlet。
如需適用於 SharePoint Embedded 容器的 Windows PowerShell 的權限和最新資訊，請參閱 SharePoint Embedded 容器管理命令介面簡介中的檔。
注意事項
您無法使用此 Cmdlet 擷取資源回收筒中的容器。
使用下列 OwningApplicationId 值來識別特定的 Microsoft 應用程式：
| 應用程式 | 擁有應用程式標識符 |
|---|---|
| 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 應用程式下建立的容器表格式清單，其中包含 OwningApplicationId2ce03211-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。
參數
-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
使用此參數來指定容器 ID。
參數屬性
| 類型: | 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。