Get-SPOContainer
Devuelve uno o varios contenedores en una aplicación de SharePoint Embedded.
Sintaxis
All (Es el 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 los 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 administrador de SharePoint Embedded para ejecutar este cmdlet.
Para obtener permisos y la información más reciente sobre Windows PowerShell para contenedores incrustados de SharePoint, consulte la documentación de Introducción al Shell de administración de contenedores incrustados de SharePoint.
Nota:
No se pueden recuperar contenedores en la papelera de reciclaje mediante este cmdlet.
Use 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 a petición de eventos de Microsoft Teams | 7fc21101-d09b-4343-8eb3-21187e0431a4 |
Ejemplos
Ejemplo 1
Get-SPOContainer
El ejemplo 1 devuelve los detalles de todos los contenedores del inquilino.
Ejemplo 2
Get-SPOContainer -Identity b!ISJs1WRro0y0EWgkUYcktDa0mE8zSlFEqFzqRn70Zwp1CEtDEBZgQICPkRbil_8U
El ejemplo 2 devuelve las propiedades detalladas del contenedor con el identificador de contenedor asociado 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 de SharePoint Embedded con el OwningApplicationId de 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 -PagingToken parámetro junto con el -Paged parámetro para ver más contenedores que no se mostraron en el 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 los contenedores que pertenecen a la aplicación, ordenados en orden ascendente de almacenamiento.
Ejemplo 9
Get-SPOContainer -OwningApplicationId 2ce03211-353e-45d7-b487-8ac6981332cf -ArchiveStatus RecentlyArchived | ft
El ejemplo 9 devuelve una lista tabular de contenedores archivados recientemente que pertenecen a la aplicación de SharePoint Embedded con el OwningApplicationId de 423poi45.
Parámetros
-ArchiveStatus
Aplicable: SharePoint Online
El parámetro ArchiveStatus se usa para mostrar contenedores en varias fases de archivado. Se admiten los siguientes estados:
- Archivado: muestra los contenedores en todos los estados archivados.
- RecentlyArchived: muestra los contenedores en el estado "Archivado recientemente".
- FullyArchived: muestra los contenedores en el estado "Totalmente archivado".
- Reactivar: muestra los contenedores en el estado "Reactivando".
- NotArchived: muestra los contenedores activos.
Propiedades del 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 |
| Mandatory: | 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 del 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 |
| Mandatory: | 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 de SharePoint Embedded. Use el Get-SPOApplication comando para recuperar OwningApplicationId.
Propiedades del parámetro
| Tipo: | System.Guid |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
OwningApplicationId
| Posición: | 0 |
| Mandatory: | 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 |
| Mandatory: | 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 |
| Mandatory: | 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 de SharePoint Embedded determinada. El uso -Paged proporcionará un token de paginación que mostrará los 200 contenedores siguientes.
Propiedades del 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 |
| Mandatory: | 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 |
| Mandatory: | 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 |
| Mandatory: | 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 que 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 se debe usar el parámetro junto con este parámetro.
Propiedades del parámetro
| Tipo: | System.String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
OwningApplicationId
| Posición: | 2 |
| Mandatory: | 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 |
| Mandatory: | 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 |
| Mandatory: | 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 del 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 |
| Mandatory: | 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.