Get-SPOContainer
Restituisce uno o più contenitori in un'applicazione SharePoint Embedded.
Sintassi
All (Impostazione predefinita)
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>]
Descrizione
Il Get-SPOContainer cmdlet recupera i dettagli di un singolo contenitore, nello stato attivo o archiviato, se associato al parametro, che richiede di specificare l'ID Identity del contenitore. Quando viene usato con il OwningApplicationId parametro, il cmdlet restituisce un elenco di contenitori attivi associati a un'applicazione SharePoint Embedded. Inoltre, se usato anche con il ArchiveStatus parametro, restituisce un elenco di contenitori nello stato archiviato come specificato.
Per eseguire questo cmdlet, è necessario essere un amministratore di SharePoint Embedded.
Per le autorizzazioni e le informazioni più aggiornate su Windows PowerShell per SharePoint Embedded Containers, vedere la documentazione in Introduzione a SharePoint Embedded Containers Management Shell.
Nota
Non è possibile recuperare i contenitori nel Cestino utilizzando questo cmdlet.
Usa i OwningApplicationId seguenti valori per identificare applicazioni Microsoft specifiche:
| Applicazione | OwningApplicationId |
|---|---|
| Agente dichiarativo Microsoft | e8be65d6-d430-4289-a665-51bf2a194bda |
| Microsoft Designer | 5e2795e3-ce8c-4cfb-b302-35fe5cd01597 |
| Microsoft Loop | a187e399-0c36-4b98-8f04-1edc167a0996 |
| Newsletter di Microsoft Outlook | 155d75a8-799c-4ad4-ae3f-0084ccced5fa |
| Video on demand per eventi di Microsoft Teams | 7fc21101-d09b-4343-8eb3-21187e0431a4 |
Esempio
Esempio 1
Get-SPOContainer
L'esempio 1 restituisce i dettagli di tutti i contenitori nel tenant.
Esempio 2
Get-SPOContainer -Identity b!ISJs1WRro0y0EWgkUYcktDa0mE8zSlFEqFzqRn70Zwp1CEtDEBZgQICPkRbil_8U
L'esempio 2 restituisce le proprietà dettagliate del contenitore con l'ID contenitore associato b! ISJs1WRro0y0EWgkUYcktDa0mE8zSlFEqFzqRn70Zwp1CEtDEBZgQICPkRbil_8U.
Esempio 3
Get-SPOContainer -OwningApplicationId 2ce03211-353e-45d7-b487-8ac6981332cf | ft
L'esempio 3 restituisce un elenco tabulare di contenitori creati nell'applicazione SharePoint Embedded con il OwningApplicationId valore di 2ce03211-353e-45d7-b487-8ac6981332cf.
Esempio 4
Get-SPOContainer -OwningApplicationId 2ce03211-353e-45d7-b487-8ac6981332cf -Paged | ft
Nell'esempio 4 viene utilizzato il -Paged comando per recuperare un token di paging.
Esempio 5
Get-SPOContainer -OwningApplicationId 2ce03211-353e-45d7-b487-8ac6981332cf -Paged -PagingToken <zacad> | ft
Nell'esempio -PagingToken 5 viene usato il parametro insieme al parametro per visualizzare più contenitori che non sono stati visualizzati nell'esempio -Paged 3.
Esempio 6
Get-SPOContainer -OwningApplicationId 2ce03211-353e-45d7-b487-8ac6981332cf -SortByStorage Ascending
Nell'esempio 6 vengono visualizzati i contenitori appartenenti all'applicazione, ordinati in ordine crescente di archiviazione.
Esempio 7
Get-SPOContainer -OwningApplicationId 2ce03211-353e-45d7-b487-8ac6981332cf -SortByStorage Ascending -Paged
L'esempio 7 mostra una visualizzazione di paging dei contenitori appartenenti all'applicazione, ordinati in ordine crescente di archiviazione.
Esempio 8
Get-SPOContainer -OwningApplicationId 2ce03211-353e-45d7-b487-8ac6981332cf -SortByStorage Ascending -Paged -PagingToken <zacad>
L'esempio 8 mostra l'elenco successivo della visualizzazione di paging dei contenitori appartenenti all'applicazione, ordinati in ordine crescente di archiviazione.
Esempio 9
Get-SPOContainer -OwningApplicationId 2ce03211-353e-45d7-b487-8ac6981332cf -ArchiveStatus RecentlyArchived | ft
L'esempio 9 restituisce un elenco tabulare dei contenitori archiviati di recente appartenenti all'applicazione SharePoint Embedded con OwningApplicationId di 423poi45.
Esempio 10
Get-SPOContainer -Identity b!ISJs1WRro0y0EWgkUYcktDa0mE8zSlFEqFzqRn70Zwp1CEtDEBZgQICPkRbil_8U | Select InformationSegment
L'esempio 10 restituisce l'valore InformationSegment associato al contenitore. Per usare questo comando, nel tenant deve essere abilitato Microsoft 365 Information Barriers. Per ulteriori informazioni, vedere Informazioni sulle barriere informative.
Parametri
-ArchiveStatus
Applicabile: SharePoint Online
Il parametro ArchiveStatus viene usato per visualizzare i contenitori in varie fasi di archiviazione. Sono supportati i seguenti stati:
- Archiviato: visualizza i contenitori in tutti gli stati archiviati.
- RecentlyArchived: visualizza i contenitori nello stato "Archiviati di recente".
- Completamente archiviato: visualizza i contenitori nello stato "Completamente archiviato".
- Riattivazione: visualizza i contenitori nello stato "Riattivazione in corso".
- NotArchived: visualizza i contenitori attivi.
Proprietà dei parametri
| Tipo: | Microsoft.Online.SharePoint.TenantAdministration.SPContainerArchiveStatusFilterProperties |
| Valore predefinito: | None |
| Valori accettati: | NotArchived, FullyArchived, RecentlyArchived, Reactivating, Archived |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
Archive
| Posizione: | 1 |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Identity
Applicabile: SharePoint Online
Usare questo parametro per specificare l'ID contenitore.
Proprietà dei parametri
| Tipo: | Microsoft.Online.SharePoint.PowerShell.SPOContainerPipeBind |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
Identity
| Posizione: | Named |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-OwningApplicationId
Applicabile: SharePoint Online
Questo parametro specifica l'ID dell'applicazione SharePoint Embedded. Usare il Get-SPOApplication comando per recuperare OwningApplicationId.
Proprietà dei parametri
| Tipo: | System.Guid |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
OwningApplicationId
| Posizione: | 0 |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
Sort
| Posizione: | 0 |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
Archive
| Posizione: | 0 |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Paged
Applicabile: SharePoint Online
Questo parametro può essere usato quando sono presenti più di 200 contenitori in una determinata applicazione SharePoint Embedded. L'uso -Paged fornirà un token di paging che visualizzerà i successivi 200 contenitori.
Proprietà dei parametri
| Tipo: | System.Management.Automation.SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
OwningApplicationId
| Posizione: | 1 |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
Sort
| Posizione: | 1 |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
Archive
| Posizione: | 1 |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-PagingToken
Applicabile: SharePoint Online
Usare questo parametro per specificare il token di paging per visualizzare i contenitori rimanenti, come illustrato nell'esempio 4. Se non ci sono altri contenitori da visualizzare, l'output del cmdlet restituirà il messaggio End of containers view. In caso contrario, usare il token di paging specificato per recuperare il batch successivo di un massimo di 200 contenitori. Per visualizzare il set successivo di contenitori archiviati, -ArchiveStatus è necessario usare il parametro insieme a questo parametro.
Proprietà dei parametri
| Tipo: | System.String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
OwningApplicationId
| Posizione: | 2 |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
Sort
| Posizione: | 2 |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
Archive
| Posizione: | 2 |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-SortByStorage
Applicabile: SharePoint Online
Questo parametro può essere usato quando è necessario visualizzare l'elenco dei contenitori, ordinati per archiviazione.
Proprietà dei parametri
| Tipo: | Microsoft.Online.SharePoint.TenantManagement.SortOrder |
| Valore predefinito: | None |
| Valori accettati: | Ascending, Descending |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
Sort
| Posizione: | 1 |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
CommonParameters
Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedere about_CommonParameters.