Get-SPOCopilotAgentInsightsReport
Este cmdlet permite ao administrador marcar status de todos os relatórios ativos e disponíveis quando não existe nenhum ID de relatório e ver ou transferir um relatório se o ID do relatório estiver presente.
Observação
A funcionalidade associada a este cmdlet será implementada em breve.
Sintaxe
Default (Padrão)
Get-SPOCopilotAgentInsightsReport
[-ReportId <Guid>]
[-Action <ActionType>]
[-Content <SPOCopilotAgentInsightType>]
[<CommonParameters>]
Description
Se este cmdlet for executado sem quaisquer parâmetros, apresenta a status de todos os relatórios ativos e concluídos com as seguintes propriedades:
| Propriedade | Descrição |
|---|---|
| Id | O ID exclusivo do relatório. |
| CreatedDateTimeInUtc | A data e hora em UTC em que a criação do relatório foi acionada. |
| Status | A status do relatório. |
| ReportPeriodInDays | A duração do relatório em dias. |
Observação
Todos os relatórios cumprem quaisquer linha do tempo de retenção de acordo com a Governação de Acesso a Dados.
Exemplos
EXEMPLO 1
Get-SPOCopilotAgentInsightsReport
O Exemplo 1 permite que o administrador veja 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 veja o relatório de informações do agente Copilot do 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 transfira o relatório de informações do agente Copilot do ReportId: 9d946216-afe7-49f5-8267-7b662435c70b para o mesmo caminho a partir do qual o comando foi executado.
Parâmetros
-Action
Aplicável: SharePoint Online
Determina se um relatório seria visualizado ou transferido. Se o valor de -Action estiver definido como View, será apresentado o resultado no ecrã do PowerShell. Caso contrário, se o valor de -Action for definido como Download, irá transferir o relatório completo no formato CSV para o mesmo caminho a partir do qual 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
Especifica o tipo de relatório a ver ou transferir. Existem três tipos de sub-relatórios: CopilotAgentsOnSites, TopSites, SiteDistribution.
Se este cmdlet for executado com -Content como CopilotAgentsOnSites, será apresentado um relatório com uma lista de todos os sites nos quais é criado um agente Copilot juntamente com os nomes do agente Copilot criado no número especificado de dias com as seguintes propriedades:
| Propriedade | Descrição |
|---|---|
| Nome do site | O nome do site do SharePoint. |
| URL | O URL do site do SharePoint. |
| Modelo | O modelo Site do site do SharePoint. |
| Proprietário do site | Nome do proprietário do site do SharePoint. |
| Nome do copilot | Nome do agente Copilot no site do SharePoint. |
| Confidencialidade | A etiqueta de confidencialidade do site do SharePoint. |
| Restringir o acesso ao site ativado | Restringir o acesso ao site status (Sim/Não) do site SharePoint. |
| Restringir a deteção de sites ativada | Restringir status de deteção de sites (Sim/Não) do site SharePoint. |
| Compartilhamento externo | Status de Partilha Externa (Sim/Não) do site SharePoint. |
Se este cmdlet for executado com -ReportId como parâmetro e -Content como TopSites, os 100 registos principais que resumem o número de agentes Copilot em sites criados no número especificado de dias serão apresentados com as seguintes propriedades:
| Propriedade | Descrição |
|---|---|
| Nome do site | O nome do site do SharePoint. |
| URL | O URL do site do SharePoint. |
| Modelo | O modelo Site do site do SharePoint. |
| Proprietário do site | Nome do proprietário do site do SharePoint. |
| Agentes copilot | Número de agentes copilot no site do SharePoint. |
| Confidencialidade | A etiqueta de confidencialidade do site do SharePoint. |
| Restringir o acesso ao site ativado | Restringir o acesso ao site status (Sim/Não) do site SharePoint. |
| Restringir a deteção de sites ativada | Restringir status de deteção de sites (Sim/Não) do site SharePoint. |
| Compartilhamento externo | Status de Partilha Externa (Sim/Não) do site SharePoint. |
Se este cmdlet for executado com -ReportId como parâmetro e -Content como SiteDistribution, um relatório que mostre a distribuição copilot entre sites no número especificado de dias será apresentado com as seguintes propriedades:
| Propriedade | Descrição |
|---|---|
| Modelos de site | O modelo Site do site do SharePoint. |
| Sites | Número de sites correspondentes a esse modelo de site específico. |
| Agentes copilot | Número de agentes 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
Especifica o ID exclusivo do relatório a ser visualizado ou transferido.
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 suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.