Get-SPOCopilotAgentInsightsReport
Este cmdlet permite al administrador comprobar el estado de todos los informes activos y disponibles cuando no hay ningún identificador de informe y ver o descargar un informe si el identificador de informe está presente.
Nota:
La característica asociada a este cmdlet se implementará pronto.
Sintaxis
Default (Es el valor predeterminado).
Get-SPOCopilotAgentInsightsReport
[-ReportId <Guid>]
[-Action <ActionType>]
[-Content <SPOCopilotAgentInsightType>]
[<CommonParameters>]
Description
Si este cmdlet se ejecuta sin parámetros, muestra el estado de todos los informes activos y completados con las siguientes propiedades:
| Propiedad | Descripción |
|---|---|
| Id | Identificador único del informe. |
| CreatedDateTimeInUtc | Fecha y hora en UTC en que se desencadenó la creación del informe. |
| Estado | Estado del informe. |
| ReportPeriodInDays | Duración del informe en días. |
Nota:
Todos los informes se adhieren a cualquier escala de tiempo de retención según la gobernanza del acceso a datos.
Ejemplos
EJEMPLO 1
Get-SPOCopilotAgentInsightsReport
El ejemplo 1 permite al administrador ver el estado de todos los informes activos y completados.
EJEMPLO 2
Get-SPOCopilotAgentInsightsReport –ReportId 9d946216-afe7-49f5-8267-7b662435c70b
El ejemplo 2 permite al administrador ver el informe de información del agente de Copilot de ReportId: 9d946216-afe7-49f5-8267-7b662435c70b.
EJEMPLO 3
Get-SPOCopilotAgentInsightsReport – ReportId 9d946216-afe7-49f5-8267-7b662435c70b -Action Download
El ejemplo 3 permite al administrador descargar el informe de información del agente de Copilot de ReportId: 9d946216-afe7-49f5-8267-7b662435c70b a la misma ruta de acceso desde donde se ejecutó el comando.
Parámetros
-Action
Aplicable: SharePoint Online
Determina si un informe se vería o descargaría. Si el valor de se establece como View, mostrará la salida en la pantalla de -Action PowerShell. De lo contrario, si el valor de -Action se establece como Download, descargará el informe completo en formato CSV a la misma ruta de acceso desde la que se ejecutó el comando.
Propiedades del parámetro
| Tipo: | ActionType |
| Valor predeterminado: | View |
| Valores aceptados: | View, Download |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Content
Aplicable: SharePoint Online
Especifica el tipo de informe que se va a ver o descargar. Hay tres tipos de sub-informes: CopilotAgentsOnSites, TopSites, SiteDistribution.
Si este cmdlet se ejecuta con -Content como CopilotAgentsOnSites, se mostrará un informe con una lista de todos los sitios en los que se crea un agente de Copilot junto con los nombres del agente de Copilot creado en el número de días especificado con las siguientes propiedades:
| Propiedad | Descripción |
|---|---|
| Nombre del sitio | Nombre del sitio de SharePoint. |
| URL | Dirección URL del sitio de SharePoint. |
| Plantilla | Plantilla de sitio del sitio de SharePoint. |
| Propietario del sitio | Nombre del propietario del sitio de SharePoint. |
| Nombre de Copilot | Nombre del agente de Copilot en el sitio de SharePoint. |
| Sensibilidad | Etiqueta de confidencialidad del sitio de SharePoint. |
| Restricción del acceso al sitio habilitado | Restringir el estado de acceso al sitio (Sí/No) del sitio de SharePoint. |
| Restricción de la detección de sitios habilitada | Restringir el estado de detección de sitios (Sí/No) del sitio de SharePoint. |
| Uso compartido externo | Estado de uso compartido externo (Sí/No) del sitio de SharePoint. |
Si este cmdlet se ejecuta con -ReportId como parámetro y -Content como TopSites, los 100 registros principales que resumen el número de agentes de Copilot en los sitios creados en el número de días especificado se mostrarán con las siguientes propiedades:
| Propiedad | Descripción |
|---|---|
| Nombre del sitio | Nombre del sitio de SharePoint. |
| URL | Dirección URL del sitio de SharePoint. |
| Plantilla | Plantilla de sitio del sitio de SharePoint. |
| Propietario del sitio | Nombre del propietario del sitio de SharePoint. |
| Agentes de Copilot | Número de agentes de Copilot en el sitio de SharePoint. |
| Sensibilidad | Etiqueta de confidencialidad del sitio de SharePoint. |
| Restricción del acceso al sitio habilitado | Restringir el estado de acceso al sitio (Sí/No) del sitio de SharePoint. |
| Restricción de la detección de sitios habilitada | Restringir el estado de detección de sitios (Sí/No) del sitio de SharePoint. |
| Uso compartido externo | Estado de uso compartido externo (Sí/No) del sitio de SharePoint. |
Si este cmdlet se ejecuta con -ReportId como parámetro y -Content como SiteDistribution, se mostrará un informe que muestra la distribución de Copilot entre sitios en el número de días especificado con las siguientes propiedades:
| Propiedad | Descripción |
|---|---|
| Plantilla de sitio | Plantilla de sitio del sitio de SharePoint. |
| Sitios | Número de sitios correspondientes a esa plantilla de sitio determinada. |
| Agentes de Copilot | Número de agentes de Copilot en el sitio de SharePoint correspondientes a esa plantilla de sitio determinada. |
Propiedades del parámetro
| Tipo: | Microsoft.Online.SharePoint.TenantAdministration.SPOCopilotAgentInsightType |
| Valor predeterminado: | CopilotAgentsOnSites |
| Valores aceptados: | CopilotAgentsOnSites, TopSites, SiteDistribution |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-ReportId
Aplicable: SharePoint Online
Especifica el identificador único del informe que se va a ver o descargar.
Propiedades del parámetro
| Tipo: | System.Guid |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
CommonParameters
Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para más información, consulte about_CommonParameters.