Partilhar via

Relatório de informações sobre agentes do SharePoint

O relatório informações sobre agentes do SharePoint fornece aos Administradores do SharePoint informações avançadas sobre os agentes do SharePoint criados recentemente em todos os sites do SharePoint e sites do OneDrive na organização. Este relatório fornece aos administradores a capacidade de saber mais sobre os sites com o maior número de agentes criados. Com este relatório, os administradores do SharePoint podem continuar a governar e manter a integridade do conteúdo utilizado pelos agentes como dados de base.

O relatório de informações baseia-se nos dados de auditoria da Microsoft registados para agentes do SharePoint através dos eventos FileCreated e FileRenamed.

Pode gerar e gerir o relatório informações do agente do SharePoint no Centro de Administração do SharePoint ou com Shell de Gerenciamento do SharePoint Online.

O que precisa para aceder ao relatório informações do Agente do SharePoint

Quais são os requisitos de licença?

A sua organização tem de ter a licença correta e cumprir determinadas permissões ou funções administrativas para utilizar a funcionalidade descrita neste artigo.

Em primeiro lugar, a sua organização tem de ter uma das seguintes licenças base:

  • Office 365 E3, E5 ou A5
  • Microsoft 365 E1, E3, E5 ou A5

Além disso, precisa de ter Microsoft 365 Copilot licença.

Observação

Tem de ser atribuída uma licença copilot a pelo menos um utilizador na sua organização (este utilizador não precisa de ser administrador do SharePoint). Se a sua organização tiver uma licença copilot e, pelo menos, uma pessoa na sua organização lhe for atribuída uma licença copilot, os administradores do SharePoint obterão automaticamente acesso às funcionalidades de Gestão Avançada do SharePoint necessárias para a implementação do Copilot.

Requisitos de administrador

Tem de ser um administrador do SharePoint ou ter permissões equivalentes.

Importante

Se não tiver uma licença de Gestão Avançada do Microsoft SharePoint, ser-lhe-á pedido para ativar a recolha de dados, para que o produto comece a recolher os dados de auditoria relevantes para criar este relatório. Depois de ativados, os relatórios podem ser gerados 24 horas depois e conter dados do ponto de recolha. Os dados são armazenados durante 28 dias. Se não forem gerados relatórios pelo menos uma vez em três meses, a recolha de dados será colocada em pausa e deverá ser ativada novamente. Para ativar a recolha de dados para estes relatórios, veja a secção Recolha de dados para informações sobre agentes do SharePoint neste artigo.

Como aceder ao relatório informações do Agente do SharePoint no Centro de Administração do SharePoint

  1. Inicie sessão no centro de administração do SharePoint com as credenciais de administrador do SharePoint para a sua organização.
  2. No painel esquerdo, expanda Relatórios e, em seguida, selecione Informações do Agente.

Como criar relatórios no Centro de Administração do SharePoint

  1. Com as permissões de um Administrador do SharePoint, pode criar o relatório ao selecionar Criar um relatório.

    Captura de ecrã a mostrar a criação de relatórios no SharePoint Agent Insights.

  2. Indique o Nome do relatório e, em Duração do relatório, especifique o período de tempo do relatório.

    Captura de ecrã a mostrar a especificação do período de tempo do relatório nas Informações do Agente do SharePoint.

  3. Selecione Criar e executar.

Observação

Pode criar um relatório para os últimos 1, 7, 14 ou 28 dias.

Ver status de relatórios no Centro de Administração do SharePoint

Para marcar se um relatório está pronto ou quando foi atualizado pela última vez, veja a coluna Estado.

Captura de ecrã do relatório status.

Ver relatório no Centro de Administração do SharePoint

Quando um relatório estiver pronto, selecione-o para ver os dados. Pode ver os 100 melhores registos que alojam o maior número de agentes. Pode procurar sites ou filtrar no modelo de site e políticas de governação.

Captura de ecrã a mostrar o relatório de visualização.

Aplicar políticas de governação de conteúdos no Centro de Administração do SharePoint

Pode aplicar políticas de governação de conteúdos nos sites a partir do relatório de informações. As políticas disponíveis são Restringir a política de acesso ao site e Restringir a política de Deteção de Conteúdos.

Captura de ecrã a mostrar a aplicação de RCD.

Observação

Depois de uma política ser aplicada ao site a partir do relatório de informações, a política status no relatório existente não será atualizada. Para ver as status atualizadas da política no site, selecione a política para ver a status mais recente ou aceder ao painel Site ativo e rever as definições do site.

Relatório do SharePoint Agent Insights no Shell de Gerenciamento do SharePoint Online

Pode gerar e gerir o relatório informações do agente do SharePoint com Shell de Gerenciamento do SharePoint Online.

  1. Se ainda não o fez, transfira e instale a versão mais recente do Shell de Gerenciamento do SharePoint Online.
  2. Ligue-se ao SharePoint Online como, pelo menos, um administrador do SharePoint no Microsoft 365. Para obter mais informações, consulte Introdução ao Shell de Gerenciamento do SharePoint Online.
  3. Para gerar e ver estes relatórios, certifique-se de que a organização tem a licença do suplemento Gestão Avançada do SharePoint ou Microsoft 365 Copilot.

Com permissões de, pelo menos, um administrador do SharePoint, pode gerar e ver o relatório de informações com os seguintes comandos:

  1. Para gerar um relatório para uma duração de relatório predefinida de um dia, execute o comando:

    Start-SPOCopilotAgentInsightsReport

  2. Para gerar um relatório para qualquer outra duração (7, 14 ou 28 dias), execute o comando:

    Start-SPOCopilotAgentInsightsReport -ReportPeriodInDays

    Por exemplo, para gerar o relatório nos últimos 28 dias, execute o comando:

    Start-SPOCopilotAgentInsightsReport -ReportPeriodInDays <28>

    Captura de ecrã a mostrar os scripts do Powershell para criar um relatório de genearte.

  3. Para marcar a status de todos os relatórios ativos e disponíveis, execute o comando:

    Get-SPOCopilotAgentInsightsReport

    Captura de ecrã do script do PowerShell status.

  4. Para marcar a status de um relatório específico, execute o comando:

    Get-SPOCopilotAgentInsightsReport –ReportId

  5. Para transferir e ver o relatório, execute o comando :

    Get-SPOCopilotAgentInsightsReport –ReportId -Action Download

    Observação

    O PowerShell apresenta até 100 registos, mas os relatórios transferidos podem conter até 1 milhão de registos.

    Get-SPOCopilotAgentInsightsReport –ReportId -Action View

  6. Para ver relatórios mais detalhados, estão disponíveis as seguintes opções:

    a. CopilotAgentsOnSites: fornece o nome de todos os agentes atualmente disponíveis em todos os sites. Este relatório contém até 1000 000 registos.

    Observação

    O valor predefinido para o -Content parâmetro é CopilotAgentsOnSites.

    Get-SPOCopilotAgentInsightsReport –ReportId -Content CopilotAgentsOnSites

    b. TopSites: fornece uma lista de 100 sites com o número de agentes disponíveis em cada site.

    Get-SPOCopilotAgentInsightsReport –ReportId -Content TopSites

    c. SiteDistribution: fornece a vista resumida de agentes em todos os tipos de sites, como Sites de comunicação, sites ligados a grupos do Microsoft 365, site do OneDrive, etc.

    Get-SPOCopilotAgentInsightsReport –ReportId -Content SiteDistribution

Recolha de dados para relatórios de informações sobre agentes do SharePoint

Se não tiver uma licença de Gestão Avançada do Microsoft SharePoint, ser-lhe-á pedido para ativar a recolha de dados. Esta secção explica como ativar e marcar status para recolha de dados para o relatório informações sobre agentes do SharePoint.

Habilitar coleta de dados

Este comando do PowerShell começa a recolher dados de auditoria para relatórios sobre atividades dos últimos 28 dias.

Start-SPOAuditDataCollectionForActivityInsights

Desativar a recolha de dados

Este comando do PowerShell deixa de recolher dados de auditoria para relatórios sobre atividades dos últimos 28 dias.


Stop-SPOAuditDataCollectionForActivityInsights

Verificar a recolha de dados status

Assim que a recolha de dados estiver ativada, os relatórios podem ser gerados após 24 horas. Para marcar se os relatórios podem ser gerados, utilize o comando do PowerShell Get-SPOAuditDataCollectionStatusForActivityInsights. O comando devolve a recolha de dados atual status, que pode ser "NotInitiated,""InProgress", "Paused". Os relatórios podem ser gerados quando o status é "Entrada".

Get-SPOAuditDataCollectionStatusForActivityInsights

Experiências conhecidas com relatórios do SharePoint Agent Insights

Seguem-se algumas experiências conhecidas com relatórios do SharePoint Agent Insights gerados no Centro de Administração do SharePoint ou com Shell de Gerenciamento do SharePoint Online:

  • Um relatório só pode ser executado novamente após 24 horas desde que o último relatório foi gerado.

  • Em inquilinos grandes, pode demorar até 48 horas para que os dados estejam disponíveis.

  • Só pode existir um relatório para cada valor do intervalo de relatórios (1, 7, 14 ou 28 dias). Isto significa que pode ver um máximo de quatro relatórios num determinado momento.

  • O relatório recentemente gerado substitui o relatório criado anteriormente pelo mesmo intervalo de datas. Para preservar o relatório criado anteriormente, transfira primeiro o relatório antes de criar um novo relatório para o mesmo intervalo de datas.

  • Estes relatórios são gerados com dados de auditoria unificados do Microsoft 365 e podem não abranger todos os eventos de auditoria.

  • Last updated on