Gerir contentores com o PowerShell

Aplica-se a: Consumir administrador de inquilinos — Administrador do SharePoint Embedded/Administrador global

Utilize Shell de Gerenciamento do SharePoint Online para automatizar a administração de aplicações e contentores do SharePoint Embedded.

O PowerShell é útil para inventário, relatórios, operações de ciclo de vida, atualizações de etiquetas de confidencialidade, configuração de partilha e revisão de permissões.

Este artigo indica os cmdlets de administrador suportados e ligações para referências de cmdlets canónicos para obter detalhes de sintaxe mais profundos.

Importante

Utilize a versão mais recente do Shell de Gerenciamento do SharePoint Online antes de executar os cmdlets de administração de contentores do SharePoint Embedded.

Antes de começar

Confirme estes pré-requisitos.

  • A sua conta tem a função administrador incorporado do SharePoint ou a função de Administrador Global.
  • Pode ligar ao inquilino com Shell de Gerenciamento do SharePoint Online.
  • Conhece o URL de administrador do inquilino.
  • Conhece o ID da aplicação proprietária ao filtrar os resultados da aplicação ou do contentor.
  • Compreende o impacto comercial antes de eliminar contentores.

Para obter detalhes sobre a função, veja Administrador do SharePoint Embedded.

Instalar Shell de Gerenciamento do SharePoint Online

Instale o Shell de Gerenciamento do SharePoint Online.

Abra-o a partir do menu Iniciar ou utilize um anfitrião do PowerShell suportado com o módulo disponível.

Instale a shell mais recente e ligue-se ao SharePoint Online antes de executar os cmdlets do SharePoint Embedded.

Para obter detalhes de ligação, veja Connect-SPOService.

Conectar ao SharePoint Online

Ligue-se ao ponto final de administração do inquilino.

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

Substitua pelo <tenant> nome do seu inquilino.

Inicie sessão com uma conta que tenha a função de administrador necessária.

Dica

Utilize uma conta administrativa dedicada que siga as políticas de acesso privilegiado da sua organização.

Inventariar aplicações Do SharePoint Embedded

Listar aplicações Do SharePoint Embedded registadas no inquilino.

Get-SPOApplication

Ver detalhes de uma aplicação proprietária específica.

Get-SPOApplication -OwningApplicationId <OwningApplicationId>

Para obter detalhes do comando, veja Get-SPOApplication.

Ver permissões de aplicações convidadas

Ver permissões de aplicação convidada para uma aplicação Do SharePoint Embedded.

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

OwningApplicationId é o ID da aplicação proprietária do SharePoint Embedded. ApplicationId é o ID da aplicação convidada que tem acesso à aplicação SharePoint Embedded.

Os cmdlets de administração de aplicações não se aplicam a Microsoft Loop.

Configurar a partilha de aplicações

Consumir administradores de inquilinos pode configurar a capacidade de partilha externa ao nível da aplicação.

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

SharingCapability suporta estes valores:

  • Disabled
  • ExistingExternalUserSharingOnly
  • ExternalUserSharingOnly
  • ExternalUserAndGuestSharing

O OverrideTenantSharingCapability valor pode ser $true ou $false. Reveja a política de partilha de inquilinos antes de substituir o comportamento de partilha de inquilinos.

Listar contentores ativos

Listar contentores ativos para uma aplicação Do SharePoint Embedded.

Get-SPOContainer -OwningApplicationId <OwningApplicationId> | FT

O OwningApplicationId é o ID da aplicação SharePoint Embedded.

Para Microsoft Loop contentores, utilize este ID de aplicação proprietário com cmdlets de administração de contentores:

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

Para obter detalhes do comando, veja Get-SPOContainer.

Listar contentores ordenados por armazenamento

Ordene contentores por armazenamento ao investigar o custo ou o crescimento.

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

Utilize Ascending ou Descending para <value>.

Utilize esta vista com Monitorizar a utilização, a faturação e os custos para encontrar aplicações ou contentores de elevado crescimento.

Obter detalhes do contentor

Ver detalhes de um contentor específico por ID de contentor ou URL do site.

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

O resultado detalhado pode incluir armazenamento, detalhes de propriedade, URL do site, informações de etiqueta e contagem de proprietários.

Utilize o URL do site ao configurar alguns controlos de conformidade no Microsoft Purview.

Definir ou remover uma etiqueta de confidencialidade

Defina a etiqueta de confidencialidade para um contentor.

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

Remova a etiqueta de confidencialidade de um contentor.

Set-SPOContainer -Identity <ContainerID> -RemoveLabel

Coordene as alterações da etiqueta de confidencialidade com os administradores de conformidade.

Para obter orientações de conformidade, veja Aplicar controlos de segurança e conformidade.

Gerir a associação a contentores

Os administradores de inquilinos que consomem podem adicionar, remover ou alterar diretamente a função de um utilizador num contentor (setembro 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 obter detalhes do comando, veja Add-SPOContainerUser, Set-SPOContainerUser e Remove-SPOContainerUser.

Eliminar um contentor

Mova um contentor para a coleção de contentores eliminados.

Remove-SPOContainer -Identity <ContainerId>

Eliminar um contentor pode causar perda de dados, ligações quebradas, falhas de aplicações e problemas de permissão.

Notifique os proprietários de contentores e proprietários de aplicações antes de eliminar.

Aviso

A eliminação de um contentor pode interromper a utilização da aplicação SharePoint Embedded que é proprietária.

Para obter detalhes do comando, veja Remove-SPOContainer.

Ver contentores eliminados

Listar contentores eliminados na coleção de contentores eliminados.

Get-SPODeletedContainer

Para obter detalhes do comando, veja Get-SPODeletedContainer.

Restaurar um contentor eliminado

Restaure um contentor eliminado a partir da coleção de contentores eliminados.

Restore-SPODeletedContainer -Identity <ContainerId>

Após o restauro, valide o contentor no centro de administração do SharePoint e peça ao proprietário da aplicação para testar a aplicação.

Eliminar permanentemente um contentor

Elimine permanentemente um contentor da coleção de contentores eliminados quando a recuperação já não for necessária.

Remove-SPODeletedContainer -Identity <ContainerId>

Para obter detalhes do comando, veja Remove-SPODeletedContainer.

Cuidado

A eliminação permanente não pode ser revertida. Confirme a retenção e os requisitos legais antes de executar este comando.

Gerir permissões de aplicações convidadas

Se for permitido, os administradores podem adicionar, editar e remover o acesso da aplicação convidada às aplicações do SharePoint Embedded. Utilize Set-SPOApplicationPermission para este cenário.

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

Para obter detalhes do comando, veja Set-SPOApplicationPermission.

Script com segurança

Siga estas práticas operacionais.

  • Exportar o inventário antes das alterações ao ciclo de vida.
  • Teste primeiro os filtros com comandos só de leitura.
  • Utilize IDs de contentor explícitos para operações de eliminação e restauro.
  • Saída do comando log para registos de alteração.
  • Notifique os proprietários da aplicação antes de eliminar ou restaurar contentores.
  • Reveja os contentores com armazenamento pesado antes de tomar decisões de custos.
  • Coordene as alterações de etiqueta e conformidade com os administradores de conformidade.

Conteúdo relacionado

Próximas etapas

Monitorize o consumo em Monitorizar a utilização, a faturação e o custo.

  • Last updated on