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 presente 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 (valor predeterminado)
Get-SPOCopilotAgentInsightsReport
[-ReportId <Guid>]
[-Action <ActionType>]
[-Content <SPOCopilotAgentInsightType>]
[<CommonParameters>]
Description
Si este cmdlet se ejecuta sin ningún parámetro, muestra el estado de todos los informes activos y finalizados con las siguientes propiedades:
| Propiedad | Descripción |
|---|---|
| Id | El identificador único del informe. |
| CreatedDateTimeInUtc | La fecha y hora en UTC en que se inició la creación del informe. |
| Estado | El estado del informe. |
| ReportPeriodInDays | La duración del informe en días. |
Nota:
Todos los informes se adhieren a cualquier cronograma de retención según Data Access Governance.
Ejemplos
EJEMPLO 1
Get-SPOCopilotAgentInsightsReport
El ejemplo 1 permite al administrador ver el estado de todos los informes activos y finalizados.
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 en la misma ruta desde donde se ejecutó el comando.
Parámetros
-Action
Aplicable: SharePoint Online
Determina si se va a ver o descargar un informe. 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 en la misma ruta desde donde se ejecutó el comando.
Propiedades de 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 |
| Obligatorio: | 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 subinformes: CopilotAgentsOnSites, TopSites y SiteDistribution.
Si este cmdlet se ejecuta con -Content as CopilotAgentsOnSites, se mostrará un informe con la 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 especificado de días con las siguientes propiedades:
| Propiedad | Descripción |
|---|---|
| Nombre del sitio | El nombre del sitio de SharePoint. |
| URL | La dirección URL del sitio de SharePoint. |
| Plantilla | La plantilla de sitio del sitio de SharePoint. |
| Propietario del sitio | Nombre del propietario del sitio de SharePoint. |
| Nombre del copiloto | Nombre del agente de Copilot en el sitio de SharePoint. |
| Sensibilidad | La etiqueta de confidencialidad del sitio de SharePoint. |
| Restringir el acceso al sitio habilitado | Restringir el estado de acceso al sitio de SharePoint (Sí/No). |
| Restringir la detección de sitios habilitada | Restringir el estado de detección del sitio (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 sitios creados en el número especificado de días se mostrarán con las siguientes propiedades:
| Propiedad | Descripción |
|---|---|
| Nombre del sitio | El nombre del sitio de SharePoint. |
| URL | La dirección URL del sitio de SharePoint. |
| Plantilla | La 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 | La etiqueta de confidencialidad del sitio de SharePoint. |
| Restringir el acceso al sitio habilitado | Restringir el estado de acceso al sitio de SharePoint (Sí/No). |
| Restringir la detección de sitios habilitada | Restringir el estado de detección del sitio (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 especificado de días con las siguientes propiedades:
| Propiedad | Descripción |
|---|---|
| Plantilla de sitio | La plantilla de sitio del sitio de SharePoint. |
| Sitios | Número de sitios correspondientes a esa plantilla de sitio en particular. |
| Agentes de Copilot | Número de agentes de Copilot en el sitio de SharePoint correspondientes a esa plantilla de sitio en particular. |
Propiedades de 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 |
| Obligatorio: | 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 de parámetro
| Tipo: | System.Guid |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | 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.