Get-SPOContainer
Devuelve uno o varios contenedores en una aplicación de SharePoint Embedded.
Sintaxis
All (valor predeterminado)
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
El Get-SPOContainer cmdlet recupera detalles de un contenedor individual, ya sea en el estado activo o archivado, cuando se empareja con el Identity parámetro, lo que requiere especificar el identificador de contenedor. Cuando se usa con el OwningApplicationId parámetro, el cmdlet devuelve una lista de contenedores activos asociados a una aplicación de SharePoint Embedded. Además, cuando también se usa con el ArchiveStatus parámetro, devuelve una lista de contenedores en el estado archivado según lo especificado.
Debe ser un administrador de SharePoint Embedded para ejecutar este cmdlet.
Para permisos y la información más actual acerca de Windows PowerShell para contenedores integrados de SharePoint, consulte la documentación de Introducción al Shell de administración de contenedores integrados de SharePoint.
Nota:
Con este cmdlet, no se pueden recuperar los contenedores de la Papelera de reciclaje.
Utilice los siguientes OwningApplicationId valores para identificar aplicaciones específicas de Microsoft:
| Aplicación | OwningApplicationId |
|---|---|
| Agente declarativo de Microsoft | e8be65d6-d430-4289-a665-51bf2a194bda |
| Microsoft Designer | 5e2795e3-ce8c-4cfb-b302-35fe5cd01597 |
| Microsoft Loop | a187e399-0c36-4b98-8f04-1edc167a0996 |
| Boletines de Microsoft Outlook | 155d75a8-799c-4ad4-ae3f-0084ccced5fa |
| Vídeo bajo demanda de eventos de Microsoft Teams | 7fc21101-d09b-4343-8eb3-21187e0431a4 |
Ejemplos
Ejemplo 1
Get-SPOContainer
En el ejemplo 1 se muestran los detalles de todos los contenedores del inquilino.
Ejemplo 2
Get-SPOContainer -Identity b!ISJs1WRro0y0EWgkUYcktDa0mE8zSlFEqFzqRn70Zwp1CEtDEBZgQICPkRbil_8U
En el ejemplo 2 se devuelven las propiedades detalladas del contenedor con el id. de contenedor b! ISJs1WRro0y0EWgkUYcktDa0mE8zSlFEqFzqRn70Zwp1CEtDEBZgQICPkRbil_8U.
Ejemplo 3
Get-SPOContainer -OwningApplicationId 2ce03211-353e-45d7-b487-8ac6981332cf | ft
El ejemplo 3 devuelve una lista tabular de contenedores creados en la aplicación SharePoint Embedded con el OwningApplicationId of 2ce03211-353e-45d7-b487-8ac6981332cf.
Ejemplo 4
Get-SPOContainer -OwningApplicationId 2ce03211-353e-45d7-b487-8ac6981332cf -Paged | ft
En el ejemplo 4 se usa el -Paged comando para recuperar un token de paginación.
Ejemplo 5
Get-SPOContainer -OwningApplicationId 2ce03211-353e-45d7-b487-8ac6981332cf -Paged -PagingToken <zacad> | ft
En el ejemplo 5 se usa el parámetro junto con el parámetro para ver más contenedores que no se mostraron en el -PagingToken-Paged ejemplo 3.
Ejemplo 6
Get-SPOContainer -OwningApplicationId 2ce03211-353e-45d7-b487-8ac6981332cf -SortByStorage Ascending
En el ejemplo 6 se muestran los contenedores que pertenecen a la aplicación, ordenados en orden ascendente de almacenamiento.
Ejemplo 7
Get-SPOContainer -OwningApplicationId 2ce03211-353e-45d7-b487-8ac6981332cf -SortByStorage Ascending -Paged
En el ejemplo 7 se muestra una vista paginada de los contenedores que pertenecen a la aplicación, ordenados en orden ascendente de almacenamiento.
Ejemplo 8
Get-SPOContainer -OwningApplicationId 2ce03211-353e-45d7-b487-8ac6981332cf -SortByStorage Ascending -Paged -PagingToken <zacad>
En el ejemplo 8 se muestra la siguiente lista de vistas paginadas de contenedores pertenecientes a la aplicación, ordenados en orden ascendente de almacenamiento.
Ejemplo 9
Get-SPOContainer -OwningApplicationId 2ce03211-353e-45d7-b487-8ac6981332cf -ArchiveStatus RecentlyArchived | ft
En el ejemplo 9 se devuelve una lista tabular de contenedores archivados recientemente pertenecientes a la aplicación SharePoint Embedded con el OwningApplicationId de 423poi45.
Ejemplo 10
Get-SPOContainer -Identity b!ISJs1WRro0y0EWgkUYcktDa0mE8zSlFEqFzqRn70Zwp1CEtDEBZgQICPkRbil_8U | Select InformationSegment
En el ejemplo 10 se muestra la InformationSegment información asociada al contenedor. Para usar este comando, el inquilino debe tener habilitadas las barreras de información de Microsoft 365. Para obtener más información, consulte Más información sobre las barreras de información.
Parámetros
-ArchiveStatus
Aplicable: SharePoint Online
El parámetro ArchiveStatus se usa para mostrar contenedores en varias fases del archivado. Se admiten los siguientes estados:
- Archivado: muestra los contenedores en todos los estados archivados.
- Archivados recientemente: muestra los contenedores con el estado "Archivado recientemente".
- Totalmente archivado: muestra los contenedores en el estado "Completamente archivado".
- Reactivación: muestra los contenedores en el estado "Reactivando".
- NotArchived: muestra los contenedores activos.
Propiedades de parámetro
| Tipo: | Microsoft.Online.SharePoint.TenantAdministration.SPContainerArchiveStatusFilterProperties |
| Valor predeterminado: | None |
| Valores aceptados: | NotArchived, FullyArchived, RecentlyArchived, Reactivating, Archived |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
Archive
| Posición: | 1 |
| Obligatorio: | True |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Identity
Aplicable: SharePoint Online
Use este parámetro para especificar el identificador de contenedor.
Propiedades de parámetro
| Tipo: | Microsoft.Online.SharePoint.PowerShell.SPOContainerPipeBind |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
Identity
| Posición: | Named |
| Obligatorio: | True |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-OwningApplicationId
Aplicable: SharePoint Online
Este parámetro especifica el identificador de la aplicación SharePoint Embedded. Use el Get-SPOApplication comando para recuperar el OwningApplicationId.
Propiedades de parámetro
| Tipo: | System.Guid |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
OwningApplicationId
| Posición: | 0 |
| Obligatorio: | True |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
Sort
| Posición: | 0 |
| Obligatorio: | True |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
Archive
| Posición: | 0 |
| Obligatorio: | True |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Paged
Aplicable: SharePoint Online
Este parámetro se puede usar cuando hay más de 200 contenedores en una aplicación SharePoint Embedded determinada. El uso -Paged proporcionará un token de paginación que mostrará los siguientes 200 contenedores.
Propiedades de parámetro
| Tipo: | System.Management.Automation.SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
OwningApplicationId
| Posición: | 1 |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
Sort
| Posición: | 1 |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
Archive
| Posición: | 1 |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-PagingToken
Aplicable: SharePoint Online
Use este parámetro para proporcionar el token de paginación para ver los contenedores restantes, como se muestra en el ejemplo 4. Si no hay más contenedores para mostrar, la salida del cmdlet devolverá el mensaje End of containers view. De lo contrario, use el token de paginación especificado para recuperar el siguiente lote de hasta 200 contenedores. Para mostrar el siguiente conjunto de contenedores archivados, -ArchiveStatus es necesario utilizar el parámetro junto con este parámetro.
Propiedades de parámetro
| Tipo: | System.String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
OwningApplicationId
| Posición: | 2 |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
Sort
| Posición: | 2 |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
Archive
| Posición: | 2 |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-SortByStorage
Aplicable: SharePoint Online
Este parámetro se puede usar cuando necesite ver la lista de contenedores, ordenados por almacenamiento.
Propiedades de parámetro
| Tipo: | Microsoft.Online.SharePoint.TenantManagement.SortOrder |
| Valor predeterminado: | None |
| Valores aceptados: | Ascending, Descending |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
Sort
| Posición: | 1 |
| Obligatorio: | True |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
CommonParameters
Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para más información, consulte about_CommonParameters.