Get-SPOContainer
Gibt einen oder mehrere Container in einer SharePoint Embedded-Anwendung zurück.
Syntax
All (Standard)
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>]
Beschreibung
Das Get-SPOContainer Cmdlet ruft Details zu einem einzelnen Container ab, entweder im aktiven oder archivierten Zustand, wenn er mit dem Identity Parameter gekoppelt ist, was die Angabe der Container-ID erfordert. Bei Verwendung mit dem OwningApplicationId Parameter gibt das Cmdlet eine Liste der aktiven Container zurück, die einer SharePoint Embedded-Anwendung zugeordnet sind. Wenn er auch mit dem ArchiveStatus Parameter verwendet wird, wird außerdem eine Liste der Container im archivierten Zustand wie angegeben zurückgegeben.
Sie müssen ein SharePoint Embedded-Administrator sein, um dieses Cmdlet ausführen zu können.
Hinweise zu Berechtigungen sowie die aktuellsten Informationen zu Windows PowerShell für eingebettete SharePoint-Container finden Sie in der Dokumentation unter Einführung in die Verwaltungsshell für eingebettete SharePoint-Container.
Hinweis
Mit diesem Cmdlet können Sie keine Container im Papierkorb abrufen.
Verwenden Sie die folgenden OwningApplicationId Werte, um bestimmte Microsoft-Anwendungen zu identifizieren:
| Application | OwningApplicationId |
|---|---|
| Microsoft Declarative Agent | e8be65d6-d430-4289-a665-51bf2a194bda |
| Microsoft Designer | 5e2795e3-ce8c-4cfb-b302-35fe5cd01597 |
| Microsoft Loop | a187e399-0c36-4b98-8f04-1edc167a0996 |
| Microsoft Outlook-Newsletter | 155d75a8-799c-4ad4-ae3f-0084ccced5fa |
| Microsoft Teams-Ereignisse – Video auf Abruf | 7fc21101-d09b-4343-8eb3-21187e0431a4 |
Beispiele
Beispiel 1
Get-SPOContainer
Beispiel 1 gibt die Details aller Container im Mandanten zurück.
Beispiel 2
Get-SPOContainer -Identity b!ISJs1WRro0y0EWgkUYcktDa0mE8zSlFEqFzqRn70Zwp1CEtDEBZgQICPkRbil_8U
Beispiel 2 gibt die detaillierten Eigenschaften des Containers mit der zugehörigen Container-ID b! ISJs1WRro0y0EWgkUYcktDa0mE8zSlFEqFzqRn70Zwp1CEtDEBZgQICPkRbil_8U.
Beispiel 3
Get-SPOContainer -OwningApplicationId 2ce03211-353e-45d7-b487-8ac6981332cf | ft
Beispiel 3 gibt eine tabellarische Liste der Container zurück, die unter der SharePoint Embedded-Anwendung erstellt wurden, mit dem Wert OwningApplicationId von 2ce03211-353e-45d7-b487-8ac6981332cf.
Beispiel 4
Get-SPOContainer -OwningApplicationId 2ce03211-353e-45d7-b487-8ac6981332cf -Paged | ft
Beispiel 4 verwendet den -Paged Befehl zum Abrufen eines Auslagerungstokens.
Beispiel 5
Get-SPOContainer -OwningApplicationId 2ce03211-353e-45d7-b487-8ac6981332cf -Paged -PagingToken <zacad> | ft
Beispiel 5 verwendet den -PagingToken Parameter zusammen mit dem -Paged Parameter, um weitere Container anzuzeigen, die in Beispiel 3 nicht angezeigt wurden.
Beispiel 6
Get-SPOContainer -OwningApplicationId 2ce03211-353e-45d7-b487-8ac6981332cf -SortByStorage Ascending
Beispiel 6 zeigt die zur Anwendung gehörenden Container, sortiert in aufsteigender Reihenfolge des Speichers.
Beispiel 7
Get-SPOContainer -OwningApplicationId 2ce03211-353e-45d7-b487-8ac6981332cf -SortByStorage Ascending -Paged
Beispiel 7 zeigt eine ausgelagerte Ansicht der zur Anwendung gehörenden Container, sortiert in aufsteigender Reihenfolge des Speichers.
Beispiel 8
Get-SPOContainer -OwningApplicationId 2ce03211-353e-45d7-b487-8ac6981332cf -SortByStorage Ascending -Paged -PagingToken <zacad>
Beispiel 8 zeigt die nächste Liste der ausgelagerten Ansicht der zur Anwendung gehörenden Container, sortiert in aufsteigender Reihenfolge des Speichers.
Beispiel 9
Get-SPOContainer -OwningApplicationId 2ce03211-353e-45d7-b487-8ac6981332cf -ArchiveStatus RecentlyArchived | ft
Beispiel 9 gibt eine tabellarische Liste der zuletzt archivierten Container zurück, die zur SharePoint Embedded-Anwendung mit der OwningApplicationId 423poi45 gehören.
Beispiel 10
Get-SPOContainer -Identity b!ISJs1WRro0y0EWgkUYcktDa0mE8zSlFEqFzqRn70Zwp1CEtDEBZgQICPkRbil_8U | Select InformationSegment
Beispiel 10 gibt das InformationSegment dem Container zugeordnete Element zurück. Um diesen Befehl verwenden zu können, müssen für Ihren Mandanten Microsoft 365-Informationsbarrieren aktiviert sein. Weitere Informationen finden Sie unter Informationen zu Informationsbarrieren.
Parameter
-ArchiveStatus
Anwendbar: SharePoint Online
Der Parameter ArchiveStatus wird verwendet, um Container in verschiedenen Phasen der Archivierung anzuzeigen. Die folgenden Zustände werden unterstützt:
- Archiviert – Zeigt Container in allen archivierten Status an.
- Zuletzt archiviert – Zeigt Container im Status "Zuletzt archiviert" an.
- Vollständig archiviert – Zeigt Container im Status "Vollständig archiviert" an.
- Reaktivieren: Zeigt Container im Status "Reaktivierung" an.
- Nicht archiviert – Zeigt aktive Container an.
Parametereigenschaften
| Typ: | Microsoft.Online.SharePoint.TenantAdministration.SPContainerArchiveStatusFilterProperties |
| Standardwert: | None |
| Zulässige Werte: | NotArchived, FullyArchived, RecentlyArchived, Reactivating, Archived |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
Archive
| Position: | 1 |
| Obligatorisch: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Identity
Anwendbar: SharePoint Online
Verwenden Sie diesen Parameter, um die Container-ID anzugeben.
Parametereigenschaften
| Typ: | Microsoft.Online.SharePoint.PowerShell.SPOContainerPipeBind |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
Identity
| Position: | Named |
| Obligatorisch: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-OwningApplicationId
Anwendbar: SharePoint Online
Dieser Parameter gibt die ID der SharePoint Embedded-Anwendung an. Verwenden Sie den Get-SPOApplication Befehl zum Abrufen der OwningApplicationId.
Parametereigenschaften
| Typ: | System.Guid |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
OwningApplicationId
| Position: | 0 |
| Obligatorisch: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
Sort
| Position: | 0 |
| Obligatorisch: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
Archive
| Position: | 0 |
| Obligatorisch: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Paged
Anwendbar: SharePoint Online
Dieser Parameter kann verwendet werden, wenn eine bestimmte SharePoint Embedded-Anwendung mehr als 200 Container enthält. Using -Paged stellt ein Auslagerungstoken bereit, das die nächsten 200 Container anzeigt.
Parametereigenschaften
| Typ: | System.Management.Automation.SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
OwningApplicationId
| Position: | 1 |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
Sort
| Position: | 1 |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
Archive
| Position: | 1 |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-PagingToken
Anwendbar: SharePoint Online
Verwenden Sie diesen Parameter, um das Auslagerungstoken bereitzustellen, um die verbleibenden Container anzuzeigen, wie in Beispiel 4 gezeigt. Wenn keine weiteren Container zur Anzeige vorhanden sind, gibt die Cmdlet-Ausgabe folgende Meldung End of containers view. zurück: Verwenden Sie andernfalls das angegebene Auslagerungstoken, um den nächsten Batch mit bis zu 200 Containern abzurufen. Für die Anzeige des nächsten Satzes archivierter Container muss der -ArchiveStatus Parameter zusammen mit diesem Parameter verwendet werden.
Parametereigenschaften
| Typ: | System.String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
OwningApplicationId
| Position: | 2 |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
Sort
| Position: | 2 |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
Archive
| Position: | 2 |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-SortByStorage
Anwendbar: SharePoint Online
Dieser Parameter kann verwendet werden, wenn Sie die Liste der Container nach Speicher sortiert anzeigen müssen.
Parametereigenschaften
| Typ: | Microsoft.Online.SharePoint.TenantManagement.SortOrder |
| Standardwert: | None |
| Zulässige Werte: | Ascending, Descending |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
Sort
| Position: | 1 |
| Obligatorisch: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
CommonParameters
Dieses Cmdlet unterstützt die allgemeinen Parameter: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen finden Sie unter about_CommonParameters.