Administración de contenedores con PowerShell

Se aplica a: Uso del administrador de inquilinos: administrador de SharePoint Embedded o administrador global

Use Shell de administración de SharePoint Online para automatizar la administración de contenedores y aplicaciones de SharePoint Embedded.

PowerShell es útil para el inventario, los informes, las operaciones del ciclo de vida, las actualizaciones de etiquetas de confidencialidad, la configuración de uso compartido y la revisión de permisos.

En este artículo se establecen los cmdlets de administrador admitidos y vínculos a referencias de cmdlet canónicos para obtener detalles más detallados de la sintaxis.

Importante

Use la versión más reciente de Shell de administración de SharePoint Online antes de ejecutar cmdlets de administración de contenedores de SharePoint Embedded.

Antes de empezar

Confirme estos requisitos previos.

  • La cuenta tiene el rol de administrador incrustado de SharePoint o el rol de administrador global.
  • Puede conectarse al inquilino con Shell de administración de SharePoint Online.
  • Conoce la dirección URL de administrador de inquilinos.
  • Conoce el identificador de aplicación propietario al filtrar los resultados de la aplicación o del contenedor.
  • Comprende el impacto empresarial antes de eliminar contenedores.

Para obtener más información sobre el rol, vea Administrador de SharePoint Embedded.

Instalar Shell de administración de SharePoint Online

Instale el Shell de administración de SharePoint Online.

Ábralo desde el menú Inicio o use un host de PowerShell compatible con el módulo disponible.

Instale el shell más reciente y conéctese a SharePoint Online antes de ejecutar cmdlets de SharePoint Embedded.

Para obtener más información sobre la conexión, consulte Connect-SPOService.

Conexión a SharePoint Online

Conéctese al punto de conexión de administrador de inquilinos.

Connect-SPOService -Url https://<tenant>-admin.sharepoint.com

Reemplace por <tenant> el nombre del inquilino.

Inicie sesión con una cuenta que tenga el rol de administrador necesario.

Sugerencia

Use una cuenta administrativa dedicada que siga las directivas de acceso con privilegios de su organización.

Inventario de aplicaciones de SharePoint Embedded

Enumera las aplicaciones de SharePoint Embedded registradas en el inquilino.

Get-SPOApplication

Ver los detalles de una aplicación propietaria específica.

Get-SPOApplication -OwningApplicationId <OwningApplicationId>

Para obtener más información sobre los comandos, consulte Get-SPOApplication.

Visualización de permisos de aplicación invitado

Ver los permisos de aplicación invitado para una aplicación de SharePoint Embedded.

Get-SPOApplication -OwningApplicationId <OwningApplicationId> -ApplicationId <ApplicationId>

OwningApplicationId es el identificador de la aplicación propietaria de SharePoint Embedded. ApplicationId es el identificador de aplicación invitado que tiene acceso a la aplicación de SharePoint Embedded.

Los cmdlets de administración de aplicaciones no se aplican a Microsoft Loop.

Configuración del uso compartido de aplicaciones

Los administradores de inquilinos que consumen pueden configurar la funcionalidad de uso compartido externo en el nivel de aplicación.

Set-SPOApplication -OwningApplicationId <OwningApplicationId> -SharingCapability <SharingCapability> -OverrideTenantSharingCapability <OverrideTenantSharingCapability>

SharingCapability admite estos valores:

  • Disabled
  • ExistingExternalUserSharingOnly
  • ExternalUserSharingOnly
  • ExternalUserAndGuestSharing

El OverrideTenantSharingCapability valor puede ser $true o $false. Revise la directiva de uso compartido de inquilinos antes de invalidar el comportamiento de uso compartido de inquilinos.

Enumerar contenedores activos

Enumerar contenedores activos para una aplicación de SharePoint Embedded.

Get-SPOContainer -OwningApplicationId <OwningApplicationId> | FT

OwningApplicationId es el identificador de la aplicación de SharePoint Embedded.

Para Microsoft Loop contenedores, use este identificador de aplicación propietario con cmdlets de administración de contenedores:

a187e399-0c36-4b98-8f04-1edc167a0996

Para obtener más información sobre los comandos, vea Get-SPOContainer.

Enumerar contenedores ordenados por almacenamiento

Ordenar contenedores por almacenamiento al investigar el costo o el crecimiento.

Get-SPOContainer -OwningApplicationId <OwningApplicationId> -SortByStorage <value> | FT

Use Ascending o Descending para <value>.

Use esta vista con Supervisar el uso, la facturación y el costo para encontrar aplicaciones o contenedores de alto crecimiento.

Obtener detalles del contenedor

Vea los detalles de un contenedor específico por identificador de contenedor o dirección URL del sitio.

Get-SPOContainer -Identity <ContainerId>
Get-SPOContainer -Identity <SiteURL>

El resultado detallado puede incluir almacenamiento, detalles de propiedad, dirección URL del sitio, información de etiqueta y recuento de propietarios.

Use la dirección URL del sitio al configurar algunos controles de cumplimiento en Microsoft Purview.

Establecimiento o eliminación de una etiqueta de confidencialidad

Establezca la etiqueta de confidencialidad de un contenedor.

Set-SPOContainer -Identity <ContainerID> -SensitivityLabel <SensitivityLabel>

Quite la etiqueta de confidencialidad de un contenedor.

Set-SPOContainer -Identity <ContainerID> -RemoveLabel

Coordine los cambios de etiqueta de confidencialidad con los administradores de cumplimiento.

Para obtener instrucciones de cumplimiento, consulte Aplicar controles de seguridad y cumplimiento.

Administración de la pertenencia a contenedores

Los administradores de inquilinos de consumo pueden agregar, quitar o cambiar el rol de un usuario en un contenedor directamente (septiembre de 2025):

Add-SPOContainerUser -ContainerId <ContainerId> -LoginName <UserPrincipalName> -Role <Reader|Writer|Manager|Owner>
Set-SPOContainerUser -ContainerId <ContainerId> -LoginName <UserPrincipalName> -Role <Reader|Writer|Manager|Owner>
Remove-SPOContainerUser -ContainerId <ContainerId> -LoginName <UserPrincipalName>

Para obtener más información sobre los comandos, vea Add-SPOContainerUser, Set-SPOContainerUser y Remove-SPOContainerUser.

Eliminación de un contenedor

Mueva un contenedor a la colección de contenedores eliminada.

Remove-SPOContainer -Identity <ContainerId>

La eliminación de un contenedor puede provocar pérdida de datos, vínculos rotos, errores de aplicación y problemas de permisos.

Notifique a los propietarios de contenedores y a los propietarios de aplicaciones antes de eliminarlos.

Advertencia

La eliminación de un contenedor puede interrumpir el uso de la aplicación de SharePoint Embedded que lo posee.

Para obtener más información sobre los comandos, vea Remove-SPOContainer.

Visualización de contenedores eliminados

Enumera los contenedores eliminados en la colección de contenedores eliminada.

Get-SPODeletedContainer

Para obtener más información sobre los comandos, vea Get-SPODeletedContainer.

Restauración de un contenedor eliminado

Restaure un contenedor eliminado de la colección de contenedores eliminada.

Restore-SPODeletedContainer -Identity <ContainerId>

Después de la restauración, valide el contenedor en el Centro de administración de SharePoint y pida al propietario de la aplicación que pruebe la aplicación.

Eliminación permanente de un contenedor

Elimine permanentemente un contenedor de la colección de contenedores eliminada cuando ya no sea necesaria la recuperación.

Remove-SPODeletedContainer -Identity <ContainerId>

Para obtener más información sobre el comando, vea Remove-SPODeletedContainer.

Precaución

No se puede invertir la eliminación permanente. Confirme los requisitos legales y de retención antes de ejecutar este comando.

Administración de permisos de aplicación invitado

Si se permite, los administradores pueden agregar, editar y quitar el acceso de aplicaciones invitadas a aplicaciones de SharePoint Embedded. Use Set-SPOApplicationPermission para este escenario.

Set-SPOApplicationPermission
   [[-OwningApplicationId] <OwningApplicationid>]
   [[-GuestApplicationId] <GuestApplicationId>]
   [[-PermissionAppOnly] <AppOnlyPermission>]
   [[-PermissionDelegated] <DelegatedPermission>]

Para obtener más información sobre los comandos, consulte Set-SPOApplicationPermission.

Script de forma segura

Siga estas prácticas operativas.

  • Exporte el inventario antes de que cambie el ciclo de vida.
  • Pruebe primero los filtros con comandos de solo lectura.
  • Use identificadores de contenedor explícitos para las operaciones de eliminación y restauración.
  • Salida del comando log para los registros de cambios.
  • Notificar a los propietarios de la aplicación antes de eliminar o restaurar contenedores.
  • Revise los contenedores pesados de almacenamiento antes de tomar decisiones de costos.
  • Coordine los cambios de etiqueta y cumplimiento con los administradores de cumplimiento.

Pasos siguientes

Supervise el consumo en Supervisión del uso, la facturación y el costo.