Richieste di esportazione che gli utenti hanno salvato, apprezzato o condiviso in Raccolta richieste di Copilot

2025-04-20

In Raccolta richieste di Copilot, gli utenti possono salvare o condividere le richieste create, incluse le richieste di condivisione con un team specifico (in Microsoft Teams) di cui sono membri. Gli utenti possono anche gradire le richieste create da altri utenti. Gli amministratori possono usare Windows PowerShell per esportare i dati in un file su uno dei tipi di prompt seguenti in Raccolta richieste di Copilot:

Richieste salvate, apprezzate e condivise di un utente specifico.
Le richieste sono condivise con un team specifico.

Nota

All'account utente che esegue lo script di PowerShell per esportare i dati deve essere assegnato il ruolo Globale Amministrazione.

Configurare l'ambiente Windows PowerShell

Prima di poter esportare le richieste che gli utenti hanno salvato, apprezzato o condiviso in Raccolta richieste di Copilot, è necessario configurare l'ambiente PowerShell seguendo questa procedura:

Scaricare lo script di PowerShell CopilotLabDSR
Installare il modulo MSAL.PS
Caricare il modulo CopilotLabDSR

Scaricare lo script di PowerShell CopilotLabDSR

Per iniziare, è necessario scaricare lo script di PowerShell CopilotLabDSR.
In Esplora file passare al percorso in cui è stato salvato il file CopilotLabDSR.psm1.
Fare clic con il pulsante destro del mouse sul file CopilotLabDSR.psm1 e scegliere Proprietà.
Nella scheda Generale selezionare La casella di controllo Sblocca e quindi selezionare OK.

È necessario sbloccare il file perché, per impostazione predefinita, l'esecuzione di script scaricati da Internet non è consentita.

Installare il modulo MSAL.PS

Controllare se il modulo MSAL.PS è installato eseguendo il comando seguente in PowerShell:
```
Get-Module -ListAvailable MSAL.PS
```
Se il modulo non è installato, installare il modulo eseguendo il comando seguente in PowerShell:
```
Install-Module -Name MSAL.PS -Scope CurrentUser 
```

Caricare il modulo CopilotLabDSR

Eseguire il comando seguente in PowerShell per abilitare l'esecuzione di script scaricati da Internet solo per questa sessione. Potrebbe essere richiesto di confermare digitando "Y".
```
Set-ExecutionPolicy -ExecutionPolicy Unrestricted -Scope Process
```
Eseguire il comando seguente per importare il modulo con tutti i cmdlet disponibili.
```
Import-module "<location where you saved the CopilotLabDSR.psm1 file>"
```
Ad esempio, se il file viene salvato in C:\AdminScripts, digitare:
```
Import-module "C:\AdminScripts\CopilotLabDSR.psm1"
```

Esportare le richieste salvate, apprezzate e condivise di un utente specifico

Da Windows PowerShell usare il Export- PromptsUserContent cmdlet per esportare le richieste salvate, con mi piace o condivise di un utente specifico da Raccolta richieste di Copilot.

Export-PromptsUserContent -UserAadIdOrPrincipalName <Entra ID or UPN of user> -ExportDirectory <output location> -PromptType <type of prompt>

Parametro	Descrizione
UserAadIdOrPrincipalName	Usare il Microsoft Entra ID o il nome dell'entità utente (UPN) dell'utente per cui si vuole esportare il contenuto.
ExportDirectory	Posizione in cui archiviare i file di output. La cartella deve esistere già. Se non specificato, i file di esportazione vengono salvati nella cartella corrente.
PromptType	Specificare "salvato" per esportare i prompt salvati dall'utente. Specificare "condiviso" per esportare i prompt per i quali è stato generato un collegamento condivisibile al prompt. Specificare "Mi piace" per esportare le richieste visualizzate dall'utente.

Ad esempio, il codice seguente esporta i prompt salvati di Reed Smiths in Raccolta richieste di Copilot usando il relativo UPN e scarica i file di esportazione nel percorso C:\PromptsExportReedSmith.

Export- PromptsUserContent -UserAadIdOrPrincipalName reedsmith@contoso.com -ExportDirectory C:\PromptsExportReedSmith -PromptType saved

Quando viene richiesto di eseguire l'autenticazione, accedere con un account a cui è assegnato il ruolo Global Amministrazione, non come utente che si vuole esportare.
Dopo aver eseguito correttamente il cmdlet di PowerShell, passare al percorso di esportazione per visualizzare i file esportati.

Richieste di esportazione condivise con un team specifico

Da Windows PowerShell usare il Export-PromptsGroupContent cmdlet per esportare i prompt pubblicati nel team specifico in Raccolta richieste di Copilot.

Export-PromptsGroupContent -M365TeamsGroupId <team ID> -ExportDirectory <output location>

Parametro	Descrizione
M365TeamsGroupId	ID del team a cui sono state condivise le richieste.
ExportDirectory	Posizione in cui archiviare i file di output. La cartella deve esistere già. Se non specificato, i file di esportazione vengono salvati nella cartella corrente.

Ad esempio, il codice seguente esporta i prompt condivisi in Raccolta richieste di Copilot al team con ID "d0efcad2-6744-0de6-0624-ea467d4293af" e scarica i file di esportazione nel percorso C:\PromptsExportReedSmith.

Export- PromptsGroupContent -M365TeamsGroupId d0efcad2-6744-0de6-0624-ea467d4293af -ExportDirectory C:\PromptsExportReedSmith

Consiglio

Per trovare l'ID del team, passare a Teams>Manage teamsnell'interfaccia di amministrazione di Teams.

Quando viene richiesto di eseguire l'autenticazione, accedere con un account a cui è assegnato il ruolo Amministrazione globale.
Dopo aver eseguito correttamente il cmdlet di PowerShell, passare al percorso di esportazione per visualizzare i file esportati.

Proprietà contenute nel file di esportazione e relative descrizioni

Dopo aver eseguito il cmdlet di PowerShell per esportare i dati dell'utente da Raccolta richieste di Copilot, si riceverà un file nella cartella del percorso di download. È possibile usare le informazioni nelle sezioni seguenti per comprendere le proprietà visualizzate nel file ricevuto.

Esportare il file per le richieste salvate, apprezzate e condivise di un utente specifico

Il nome del file è preceduto da "User" e il Microsoft Entra ID dell'utente seguito dal tipo di prompt utilizzato per l'esportazione. Il file include le proprietà elencate nella tabella seguente.

Proprietà	Descrizione
Prompt	Una matrice di utenti salvati o condivisi richiede informazioni.
Prompt.Title	Titolo della richiesta fornita dall'utente durante il salvataggio o la condivisione del prompt.
Prompt.PromptText	Testo della richiesta
Prompt.Products	Elenco contenente il prodotto in cui l'utente ha salvato o condiviso la richiesta.
Prompt.IsFavorite	Valore booleano (true o false) che indica che il prompt è stato salvato o apprezzato da un utente.
Prompt.UserActivity.Favorite.IsFavorite	Valore booleano (true o false) che indica che il prompt è stato salvato o apprezzato da un utente.
Prompt.UserActivity.Favorite.ActivityDateTimeInUtc	Ora in cui l'utente ha salvato o apprezzato la richiesta.
Prompt.CreatedTime	Ora in cui l'utente ha salvato la richiesta.
Prompt.SharedTime	Ora in cui l'utente ha condiviso la richiesta
Prompt.HydratedEntities	Elenco di entità con informazioni sul tipo e sull'entità.
Prompt.HydratedEntities.Type	Attualmente sono supportati i tipi di entità Persone, File e Riunione.
Prompt.HydratedEntities.Entity	Informazioni sull'entità in base al tipo di entità.
Prompt.HydratedEntities.Entity.Id	ID entità univoco.
Prompt.HydratedEntities.Entity.DisplayName	Nome visualizzato dell'entità person.
Prompt.HydratedEntities.Entity.EmailAddresses	Elenco di indirizzi di posta elettronica per l'entità persona.
Prompt.HydratedEntities.Entity.ReferenceId	ID univoco per il mapping di strumentazione.
Prompt.HydratedEntities.Entity.FileName	Nome dell'entità file.
Prompt.HydratedEntities.Entity.AccessUrl	URL di accesso dell'entità file.
Prompt.HydratedEntities.Entity.SpoId	Identificatore documento di SharePoint per l'entità File.
Prompt.HydratedEntities.Entity.OriginalId	ID riunione dell'entità evento.
Prompt.HydratedEntities.Entity.Subject	Oggetto dell'entità evento.
Prompt.HydratedEntities.Entity.SkypeTeamsMeetingUrl	URL dell'entità evento.
Prompt.HydratedEntities.Entity.Start	Ora di inizio dell'entità evento.
Prompt.HydratedEntities.Entity.End	Ora di fine dell'entità evento.
Prompt.HydratedEntities.Entity.OrganizerName	Organizer Nome dell'entità evento.
Prompt.HydratedEntities.Entity.OrganizerAddress	Indirizzo organizzatore dell'entità evento.
Prompt.HydratedEntities.Entity.Attendees	Elenco di partecipanti dell'entità evento.

Esportare il file per le richieste condivise con un team specifico

Il nome del file è preceduto da "Group" e dall'ID del team. Il file include le proprietà elencate nella tabella seguente.

Proprietà	Descrizione
Prompt	Una matrice di utenti salvati o condivisi richiede informazioni.
Prompt.Title	Titolo della richiesta fornita dall'utente durante il salvataggio o la condivisione del prompt.
Prompt.PromptText	Testo della richiesta
Prompt.Products	Elenco contenente il prodotto in cui l'utente ha salvato o condiviso la richiesta.
Prompt.PublishedTime	Ora di pubblicazione della richiesta nel team.
Prompt.PublishedBy	UPN dell'utente che ha pubblicato la richiesta al team.
Prompt.HydratedEntities	Elenco di entità con informazioni sul tipo e sull'entità.
Prompt.HydratedEntities.Type	Attualmente sono supportati i tipi di entità Persone, File e Riunione.
Prompt.HydratedEntities.Entity	Informazioni sull'entità in base al tipo di entità.
Prompt.HydratedEntities.Entity.Id	ID entità univoco.
Prompt.HydratedEntities.Entity.DisplayName	Nome visualizzato dell'entità person.
Prompt.HydratedEntities.Entity.EmailAddresses	Elenco di indirizzi di posta elettronica per l'entità persona.
Prompt.HydratedEntities.Entity.ReferenceId	ID univoco per il mapping di strumentazione.
Prompt.HydratedEntities.Entity.FileName	Nome dell'entità file.
Prompt.HydratedEntities.Entity.AccessUrl	URL di accesso dell'entità file.
Prompt.HydratedEntities.Entity.SpoId	Identificatore documento di SharePoint per l'entità File.
Prompt.HydratedEntities.Entity.OriginalId	ID riunione dell'entità evento.
Prompt.HydratedEntities.Entity.Subject	Oggetto dell'entità evento.
Prompt.HydratedEntities.Entity.SkypeTeamsMeetingUrl	URL dell'entità evento.
Prompt.HydratedEntities.Entity.Start	Ora di inizio dell'entità evento.
Prompt.HydratedEntities.Entity.End	Ora di fine dell'entità evento.
Prompt.HydratedEntities.Entity.OrganizerName	Organizer Nome dell'entità evento.
Prompt.HydratedEntities.Entity.OrganizerAddress	Indirizzo organizzatore dell'entità evento.
Prompt.HydratedEntities.Entity.Attendees	Elenco di partecipanti dell'entità evento.