Get-SPOContainer
Retorna um ou mais contêineres em um aplicativo incorporado do SharePoint.
Sintaxe
All (Default)
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
O Get-SPOContainer cmdlet recupera detalhes de um contêiner individual, no estado ativo ou arquivado, quando emparelhado com o parâmetro, o Identity que requer a especificação da ID do contêiner. Quando usado com o OwningApplicationId parâmetro, o cmdlet retorna uma lista de contêineres ativos associados a um aplicativo incorporado do SharePoint. Além disso, quando também usado com o ArchiveStatus parâmetro, ele retorna uma lista de contêineres no estado arquivado, conforme especificado.
Você deve ser um Administrador do SharePoint Embedded para executar esse cmdlet.
Para obter permissões e as informações mais atualizadas sobre o Windows PowerShell para Contêineres Incorporados do SharePoint, consulte a documentação em Introdução ao Shell de Gerenciamento de Contêineres Incorporados do SharePoint.
Observação
Você não pode recuperar contêineres na Lixeira usando este cmdlet.
Use os seguintes OwningApplicationId valores para identificar aplicativos específicos da Microsoft:
| Application | OwningApplicationId |
|---|---|
| Microsoft Declarative Agent | e8be65d6-d430-4289-a665-51bf2a194bda |
| Microsoft Designer | 5e2795e3-ce8c-4cfb-b302-35fe5cd01597 |
| Microsoft Loop | a187e399-0c36-4b98-8f04-1edc167a0996 |
| Boletins informativos do Microsoft Outlook | 155d75a8-799c-4ad4-ae3f-0084ccced5fa |
| Eventos do Microsoft Teams Vídeo sob Demanda | 7fc21101-d09b-4343-8eb3-21187e0431a4 |
Exemplos
Exemplo 1
Get-SPOContainer
O Exemplo 1 retorna os detalhes de todos os contêineres no locatário.
Exemplo 2
Get-SPOContainer -Identity b!ISJs1WRro0y0EWgkUYcktDa0mE8zSlFEqFzqRn70Zwp1CEtDEBZgQICPkRbil_8U
O Exemplo 2 retorna as propriedades detalhadas do Contêiner com a ID de Contêiner associada b! ISJs1WRro0y0EWgkUYcktDa0mE8zSlFEqFzqRn70Zwp1CEtDEBZgQICPkRbil_8U.
Exemplo 3
Get-SPOContainer -OwningApplicationId 2ce03211-353e-45d7-b487-8ac6981332cf | ft
O Exemplo 3 retorna uma lista tabular de Contêineres criados sob o aplicativo SharePoint Embedded com o OwningApplicationId de 2ce03211-353e-45d7-b487-8ac6981332cf.
Exemplo 4
Get-SPOContainer -OwningApplicationId 2ce03211-353e-45d7-b487-8ac6981332cf -Paged | ft
O exemplo 4 usa o -Paged comando para recuperar um token de paginação.
Exemplo 5
Get-SPOContainer -OwningApplicationId 2ce03211-353e-45d7-b487-8ac6981332cf -Paged -PagingToken <zacad> | ft
O Exemplo 5 usa o -PagingToken parâmetro junto com o -Paged parâmetro para exibir mais contêineres que não foram exibidos no Exemplo 3.
Exemplo 6
Get-SPOContainer -OwningApplicationId 2ce03211-353e-45d7-b487-8ac6981332cf -SortByStorage Ascending
O Exemplo 6 exibe os contêineres pertencentes ao aplicativo, classificados em ordem crescente de armazenamento.
Exemplo 7
Get-SPOContainer -OwningApplicationId 2ce03211-353e-45d7-b487-8ac6981332cf -SortByStorage Ascending -Paged
O Exemplo 7 exibe uma exibição paginada dos contêineres pertencentes ao aplicativo, classificados em ordem crescente de armazenamento.
Exemplo 8
Get-SPOContainer -OwningApplicationId 2ce03211-353e-45d7-b487-8ac6981332cf -SortByStorage Ascending -Paged -PagingToken <zacad>
O Exemplo 8 exibe a próxima lista de exibição paginada de contêineres pertencentes ao aplicativo, classificados em ordem crescente de armazenamento.
Exemplo 9
Get-SPOContainer -OwningApplicationId 2ce03211-353e-45d7-b487-8ac6981332cf -ArchiveStatus RecentlyArchived | ft
O Exemplo 9 retorna uma lista tabular de contêineres arquivados recentemente pertencentes ao aplicativo SharePoint Embedded com o OwningApplicationId de 423poi45.
Exemplo 10
Get-SPOContainer -Identity b!ISJs1WRro0y0EWgkUYcktDa0mE8zSlFEqFzqRn70Zwp1CEtDEBZgQICPkRbil_8U | Select InformationSegment
O exemplo 10 retorna o InformationSegment associado ao contêiner. Para usar esse comando, seu locatário deve ter as Barreiras de Informações do Microsoft 365 habilitadas. Para obter mais informações, consulte Saiba mais sobre Barreiras de Informações.
Parâmetros
-ArchiveStatus
Aplicável: SharePoint Online
O parâmetro ArchiveStatus é usado para exibir contêineres em vários estágios de arquivamento. Há suporte para os seguintes estados:
- Arquivado – Exibe contêineres em todos os estados arquivados.
- RecentlyArchived – exibe contêineres no estado "Arquivados recentemente".
- FullyArchived – exibe contêineres no estado "Totalmente arquivado".
- Reativando – Exibe contêineres no estado "Reativando".
- NotArchived - exibe contêineres ativos.
Propriedades do parâmetro
| Tipo: | Microsoft.Online.SharePoint.TenantAdministration.SPContainerArchiveStatusFilterProperties |
| Valor padrão: | None |
| Valores aceitos: | NotArchived, FullyArchived, RecentlyArchived, Reactivating, Archived |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
Archive
| Cargo: | 1 |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Identity
Aplicável: SharePoint Online
Use este parâmetro para especificar a ID do contêiner.
Propriedades do parâmetro
| Tipo: | Microsoft.Online.SharePoint.PowerShell.SPOContainerPipeBind |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
Identity
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-OwningApplicationId
Aplicável: SharePoint Online
Esse parâmetro especifica a ID do aplicativo Embedded do SharePoint. Use o Get-SPOApplication comando para recuperar o OwningApplicationId.
Propriedades do parâmetro
| Tipo: | System.Guid |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
OwningApplicationId
| Cargo: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
Sort
| Cargo: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
Archive
| Cargo: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Paged
Aplicável: SharePoint Online
Esse parâmetro pode ser usado quando há mais de 200 contêineres em um determinado aplicativo do SharePoint Embedded. O uso -Paged fornecerá um token de paginação que exibirá os próximos 200 contêineres.
Propriedades do parâmetro
| Tipo: | System.Management.Automation.SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
OwningApplicationId
| Cargo: | 1 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
Sort
| Cargo: | 1 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
Archive
| Cargo: | 1 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-PagingToken
Aplicável: SharePoint Online
Use esse parâmetro para fornecer o token de paginação para exibir os contêineres restantes, conforme mostrado no Exemplo 4. Se não houver mais contêineres para exibição, a saída do cmdlet retornará a mensagem End of containers view. Caso contrário, use o token de paginação fornecido para recuperar o próximo lote de até 200 contêineres. Para exibir o próximo conjunto de contêineres arquivados, -ArchiveStatus o parâmetro precisa ser usado junto com esse parâmetro.
Propriedades do parâmetro
| Tipo: | System.String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
OwningApplicationId
| Cargo: | 2 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
Sort
| Cargo: | 2 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
Archive
| Cargo: | 2 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-SortByStorage
Aplicável: SharePoint Online
Este parâmetro pode ser usado quando você precisa ver a lista de contêineres, classificados por armazenamento.
Propriedades do parâmetro
| Tipo: | Microsoft.Online.SharePoint.TenantManagement.SortOrder |
| Valor padrão: | None |
| Valores aceitos: | Ascending, Descending |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
Sort
| Cargo: | 1 |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
CommonParameters
Este cmdlet dá suporte aos parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.