Get-SPOContainer
Devolve um ou mais contentores numa aplicação Do SharePoint Embedded.
Sintaxe
All (Padrão)
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 obtém os detalhes de um contentor individual, quer no estado ativo ou arquivado, quando emparelhado com o parâmetro , que Identity requer a especificação do ID do contentor. Quando utilizado com o parâmetro , o cmdlet devolve uma lista de contentores ativos associados a uma aplicação OwningApplicationId Do SharePoint Embedded. Além disso, quando também é utilizado com o ArchiveStatus parâmetro , devolve uma lista de contentores no estado arquivado, conforme especificado.
Tem de ser um Administrador Incorporado do SharePoint para executar este cmdlet.
Para obter permissões e as informações mais recentes sobre Windows PowerShell para Contentores Incorporados do SharePoint, veja a documentação em Introdução à Shell de Gestão de Contentores Incorporados do SharePoint.
Observação
Não pode obter contentores na Reciclagem com este cmdlet.
Utilize os seguintes OwningApplicationId valores para identificar aplicações Específicas 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 |
| Microsoft Outlook Newsletters | 155d75a8-799c-4ad4-ae3f-0084ccced5fa |
| Vídeo de Eventos do Microsoft Teams a Pedido | 7fc21101-d09b-4343-8eb3-21187e0431a4 |
Exemplos
Exemplo 1
Get-SPOContainer
O exemplo 1 devolve os detalhes de todos os contentores no inquilino.
Exemplo 2
Get-SPOContainer -Identity b!ISJs1WRro0y0EWgkUYcktDa0mE8zSlFEqFzqRn70Zwp1CEtDEBZgQICPkRbil_8U
O exemplo 2 devolve as propriedades detalhadas do Contentor com o ID de Contentor b associado! ISJs1WRro0y0EWgkUYcktDa0mE8zSlFEqFzqRn70Zwp1CEtDEBZgQICPkRbil_8U.
Exemplo 3
Get-SPOContainer -OwningApplicationId 2ce03211-353e-45d7-b487-8ac6981332cf | ft
O Exemplo 3 devolve uma lista tabular de Contentores criados na aplicação 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 utiliza o -Paged comando para obter um token de paginação.
Exemplo 5
Get-SPOContainer -OwningApplicationId 2ce03211-353e-45d7-b487-8ac6981332cf -Paged -PagingToken <zacad> | ft
O exemplo 5 utiliza o -PagingToken parâmetro juntamente com o -Paged parâmetro para ver mais contentores que não foram apresentados no Exemplo 3.
Exemplo 6
Get-SPOContainer -OwningApplicationId 2ce03211-353e-45d7-b487-8ac6981332cf -SortByStorage Ascending
O exemplo 6 apresenta os contentores pertencentes à aplicação, ordenados por ordem ascendente de armazenamento.
Exemplo 7
Get-SPOContainer -OwningApplicationId 2ce03211-353e-45d7-b487-8ac6981332cf -SortByStorage Ascending -Paged
O exemplo 7 apresenta uma vista paginada dos contentores pertencentes à aplicação, ordenados por ordem ascendente de armazenamento.
Exemplo 8
Get-SPOContainer -OwningApplicationId 2ce03211-353e-45d7-b487-8ac6981332cf -SortByStorage Ascending -Paged -PagingToken <zacad>
O exemplo 8 apresenta a lista seguinte da vista paginada dos contentores pertencentes à aplicação, ordenados por ordem ascendente de armazenamento.
Exemplo 9
Get-SPOContainer -OwningApplicationId 2ce03211-353e-45d7-b487-8ac6981332cf -ArchiveStatus RecentlyArchived | ft
O exemplo 9 devolve uma lista tabular de contentores arquivados recentemente pertencentes à aplicação SharePoint Embedded com o OwningApplicationId de 423poi45.
Parâmetros
-ArchiveStatus
Aplicável: SharePoint Online
O parâmetro ArchiveStatus é utilizado para apresentar contentores em várias fases do arquivo. São suportados os seguintes estados:
- Arquivado – apresenta contentores em todos os estados arquivados.
- RecentlyArchived – apresenta contentores no estado "Arquivado recentemente".
- FullyArchived – apresenta contentores no estado "Totalmente arquivado".
- Reativação – apresenta contentores no estado "Reativação".
- NotArchived – apresenta contentores 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
Utilize este parâmetro para especificar o ID de Contentor.
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
Este parâmetro especifica o ID da aplicação SharePoint Embedded. Utilize o Get-SPOApplication comando para obter 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
Este parâmetro pode ser utilizado quando existem mais de 200 contentores numa determinada aplicação do SharePoint Embedded. A utilização -Paged irá fornecer um token de paginação que irá apresentar os próximos 200 Contentores.
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
Utilize este parâmetro para fornecer o token de paginação para ver os contentores restantes, conforme mostrado no Exemplo 4. Se não existirem mais contentores para apresentar, a saída do cmdlet devolverá a mensagem End of containers view. Caso contrário, utilize o token de paginação especificado para obter o próximo lote de até 200 contentores. Para apresentar o próximo conjunto de contentores arquivados, -ArchiveStatus o parâmetro tem de ser utilizado juntamente com este 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 utilizado quando precisar de ver a lista de contentores, ordenados 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 suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.