Get-SPOCopilotAgentInsightsReport
Este cmdlet permite ao administrador marcar status de todos os relatórios ativos e disponíveis quando nenhuma ID de relatório estiver presente e a exibir ou baixar um relatório se a ID do relatório estiver presente.
Observação
O recurso associado a este cmdlet será distribuído em breve.
Sintaxe
Default (Default)
Get-SPOCopilotAgentInsightsReport
[-ReportId <Guid>]
[-Action <ActionType>]
[-Content <SPOCopilotAgentInsightType>]
[<CommonParameters>]
Description
Se esse cmdlet for executado sem parâmetros, ele exibirá o status de todos os relatórios ativos e concluídos com as seguintes propriedades:
| Propriedade | Descrição |
|---|---|
| Id | A ID exclusiva do relatório. |
| CreatedDateTimeInUtc | A data e a hora em UTC em que a criação do relatório foi acionada. |
| Status | O status do relatório. |
| ReportPeriodInDays | A duração do relatório em dias. |
Observação
Todos os relatórios seguem qualquer linha do tempo de retenção de acordo com a Governança de Acesso a Dados.
Exemplos
EXEMPLO 1
Get-SPOCopilotAgentInsightsReport
O Exemplo 1 permite que o administrador exiba o status de todos os relatórios ativos e concluídos.
EXEMPLO 2
Get-SPOCopilotAgentInsightsReport –ReportId 9d946216-afe7-49f5-8267-7b662435c70b
O exemplo 2 permite que o administrador exiba o relatório de insight do agente do Copilot de ReportId: 9d946216-afe7-49f5-8267-7b662435c70b.
EXEMPLO 3
Get-SPOCopilotAgentInsightsReport – ReportId 9d946216-afe7-49f5-8267-7b662435c70b -Action Download
O exemplo 3 permite que o administrador baixe o relatório de insight do agente Copilot de ReportId: 9d946216-afe7-49f5-8267-7b662435c70b para o mesmo caminho de onde o comando foi executado.
Parâmetros
-Action
Aplicável: SharePoint Online
Ele determina se um relatório seria exibido ou baixado. Se o valor for -Action definido como View, ele exibirá a saída na tela do PowerShell. Caso contrário, se o valor de -Action for definido como Download, ele fará o download do relatório completo no formato CSV para o mesmo caminho de onde o comando foi executado.
Propriedades do parâmetro
| Tipo: | ActionType |
| Valor padrão: | View |
| Valores aceitos: | View, Download |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Content
Aplicável: SharePoint Online
Ele especifica o tipo de relatório a ser exibido ou baixado. Há 3 tipos de sub-relatórios: CopilotAgentsOnSites, TopSites, SiteDistribution.
Se este cmdlet for executado com -Content como CopilotAgentsOnSites, um relatório com a lista de todos os sites nos quais um agente Copilot é criado, juntamente com os nomes do agente Copilot criado no número de dias especificado, será exibido com as seguintes propriedades:
| Propriedade | Descrição |
|---|---|
| Nome do site | O nome do site do SharePoint. |
| URL | A URL do site do SharePoint. |
| Modelo | O modelo de site do site do SharePoint. |
| Proprietário do site | Nome do proprietário do site do SharePoint. |
| Nome do Copilot | Nome do agente do Copilot no site do SharePoint. |
| Confidencialidade | O rótulo de confidencialidade do site do SharePoint. |
| Restringir acesso ao site habilitado | Restringir o status de acesso ao site (Sim/Não) do site do SharePoint. |
| Restringir descoberta de site habilitada | Restringir o status de descoberta de site (Sim/Não) do site do SharePoint. |
| Compartilhamento externo | Status de compartilhamento externo (Sim/Não) do site do SharePoint. |
Se esse cmdlet for executado com -ReportId o parâmetro -ContentTopSitesas , os 100 principais registros que resumem o número de agentes do Copilot em sites criados no número de dias especificado serão exibidos com as seguintes propriedades:
| Propriedade | Descrição |
|---|---|
| Nome do site | O nome do site do SharePoint. |
| URL | A URL do site do SharePoint. |
| Modelo | O modelo de site do site do SharePoint. |
| Proprietário do site | Nome do proprietário do site do SharePoint. |
| Agentes do Copilot | Número de agentes do Copilot no site do SharePoint. |
| Confidencialidade | O rótulo de confidencialidade do site do SharePoint. |
| Restringir acesso ao site habilitado | Restringir o status de acesso ao site (Sim/Não) do site do SharePoint. |
| Restringir descoberta de site habilitada | Restringir o status de descoberta de site (Sim/Não) do site do SharePoint. |
| Compartilhamento externo | Status de compartilhamento externo (Sim/Não) do site do SharePoint. |
Se esse cmdlet for executado com -ReportId o parâmetro as , -ContentSiteDistributionserá exibido um relatório mostrando a distribuição do Copilot entre sites no número de dias especificado com as seguintes propriedades:
| Propriedade | Descrição |
|---|---|
| Modelos de site | O modelo de site do site do SharePoint. |
| Sites | Número de sites correspondentes a esse modelo de site específico. |
| Agentes do Copilot | Número de agentes do Copilot no site do SharePoint correspondentes a esse modelo de site específico. |
Propriedades do parâmetro
| Tipo: | Microsoft.Online.SharePoint.TenantAdministration.SPOCopilotAgentInsightType |
| Valor padrão: | CopilotAgentsOnSites |
| Valores aceitos: | CopilotAgentsOnSites, TopSites, SiteDistribution |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-ReportId
Aplicável: SharePoint Online
Ela especifica a ID exclusiva do relatório a ser exibido ou baixado.
Propriedades do parâmetro
| Tipo: | System.Guid |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
CommonParameters
Este cmdlet dá suporte aos parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.