Esportare le richieste salvate, apprezzate o condivise dagli utenti nella Raccolta prompt di Copilot

Nella Raccolta prompt di Copilot, gli utenti possono salvare o condividere le richieste che hanno creato, inclusa la condivisione delle richieste con un team specifico (in Microsoft Teams) di cui sono membri. Agli utenti possono anche piacere le richieste create da altri utenti. Gli amministratori possono usare Windows PowerShell per esportare dati in un file relativi a uno dei seguenti tipi di prompt nella Raccolta prompt di Copilot:

  • Le richieste salvate, apprezzate e condivise di un utente specifico.
  • I prompt condivisi con un team specifico.

Configurare l'ambiente di Windows PowerShell

L'account utente che esegue lo script PowerShell per esportare i dati deve essere assegnato al ruolo di amministratore globale.

Importante

Microsoft consiglia di usare i ruoli con il minor numero di autorizzazioni. L'uso di account con autorizzazioni inferiori consente di migliorare la sicurezza per l'organizzazione. Amministratore globale è un ruolo con privilegi elevati che deve essere limitato agli scenari di emergenza quando non è possibile usare un ruolo esistente. Per altre informazioni, vedere Informazioni sui ruoli di amministratore nell'interfaccia di amministrazione di Microsoft 365.

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

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

Scaricare lo script di PowerShell CopilotLabDSR

  1. Per iniziare, è necessario scaricare lo script PowerShell di CopilotLabDSR.

  2. In Esplora file, vai al percorso in cui hai salvato il file CopilotLabDSR.psm1.

  3. Fai clic con il pulsante destro del mouse sul file CopilotLabDSR.psm1 e seleziona Proprietà.

  4. Nella scheda Generale , selezionare la casella di controllo Sblocca , 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

  1. Controlla se il modulo MSAL.PS è installato eseguendo questo comando in PowerShell:

    Get-Module -ListAvailable MSAL.PS
    
  2. Se il modulo non è installato, installarlo eseguendo il comando seguente in PowerShell:

    Install-Module -Name MSAL.PS -Scope CurrentUser 
    

Carica il modulo CopilotLabDSR

  1. 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
    
  2. 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

  1. Da Windows PowerShell, usare il Export-PromptsUserContent cmdlet per esportare le richieste salvate, apprezzate o condivise di un utente specifico dalla Raccolta prompt di Copilot.

    Export-PromptsUserContent -UserAadIdOrPrincipalName <Entra ID or UPN of user> -ExportDirectory <output location> -PromptType <type of prompt>
    
    Parametro Descrizione
    UserAadIdOrPrincipalName Utilizzare il Microsoft Entra ID o il nome dell'entità utente (UPN) dell'utente per il quale si desidera 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.
    Tipo di prompt Specifica "salvato" per esportare le richieste salvate dall'utente. Specifica "condiviso" per esportare le richieste per le quali è stato generato un collegamento condivisibile alla richiesta. Specifica "Mi piace" per esportare le richieste piaciute all'utente.

    Ad esempio, quanto segue esporta le richieste salvate da Reed Smith nella Raccolta prompt di Copilot usando il relativo UPN e scarica i file di esportazione nella posizione C:\PromptsExportReedSmith.

    Export-PromptsUserContent -UserAadIdOrPrincipalName reedsmith@contoso.com -ExportDirectory C:\PromptsExportReedSmith -PromptType saved
    
  2. Quando viene richiesto di eseguire l'autenticazione, accedere con un account assegnato al ruolo di Amministratore globale, non come utente da esportare.

  3. Dopo che il cmdlet di PowerShell è stato eseguito correttamente, passare al percorso di esportazione per visualizzare i file esportati.

Esportare richieste condivise con un team specifico

  1. Da Windows PowerShell, usare il Export-PromptsGroupContent cmdlet per esportare le richieste pubblicate nel team specifico nella Raccolta prompt di Copilot.

    Export-PromptsGroupContent -M365TeamsGroupId <team ID> -ExportDirectory <output location>
    
    Parametro Descrizione
    M365TeamsGroupId ID del team con 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, quanto segue esporta i prompt condivisi nella Raccolta prompt di Copilot al team con ID "d0efcad2-6744-0de6-0624-ea467d4293af" e scarica i file di esportazione nella posizione C:\PromptsExportReedSmith.

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

    Consiglio

    Per trovare l'ID del team, passare a Teams>Gestire i teamnell'interfaccia di amministrazione di Teams.

  2. Quando viene richiesto di eseguire l'autenticazione, accedere con un account assegnato al ruolo di Amministrazione globale.

  3. Dopo che il cmdlet di PowerShell è stato eseguito correttamente, 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 dalla Raccolta prompt di Copilot, si riceverà un file nella cartella del percorso di download. È possibile utilizzare le informazioni delle 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 "Utente" e il Microsoft Entra ID dell'utente, seguito dal tipo di prompt usato per l'esportazione. Il file presenta le proprietà elencate nella tabella seguente.

Proprietà Descrizione
Prompt Una matrice di utenti ha salvato o condiviso le informazioni sulle richieste.
Prompt.Title Titolo della richiesta fornita dall'utente durante il salvataggio o la condivisione della richiesta.
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 un utente ha salvato o messo "Mi piace" alla richiesta.
Prompt.UserActivity.Favorite.IsFavorite Valore booleano (true o false) che indica che un utente ha salvato o messo "Mi piace" alla richiesta.
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 il prompt
Prompt.HydratedEntities Elenco di entità con informazioni su tipo ed entità.
Prompt.HydratedEntities.Type Attualmente sono supportati i tipi di entità People, File e Riunione.
Prompt.HydratedEntities.Entity Informazioni sull'entità in base al tipo di entità.
Prompt.HydratedEntities.Entity.Id ID univoco dell'entità.
Prompt.HydratedEntities.Entity.DisplayName Nome visualizzato dell'entità persona.
Prompt.HydratedEntities.Entity.EmailAddresses Elenco di indirizzi di posta elettronica per l'entità persona.
Prompt.HydratedEntities.Entity.ReferenceId ID univoco per il mapping della strumentazione.
Prompt.HydratedEntities.Entity.FileName Nome dell'entità file.
Prompt.HydratedEntities.Entity.AccessUrl URL di accesso dell'entità file.
Prompt.HydratedEntities.Entity.SpoId Identificatore del documento 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 Nome dell'organizzatore dell'evento
Prompt.HydratedEntities.Entity.OrganizerAddress Indirizzo dell'organizzatore dell'evento
Prompt.HydratedEntities.Entity.Attendees Elenco dei partecipanti dell'entità evento.

Esportare il file per le richieste condivise con un team specifico

Il nome del file è preceduto dal prefisso "Gruppo" e dall'ID del team. Il file presenta le proprietà elencate nella tabella seguente.

Proprietà Descrizione
Prompt Una matrice di utenti ha salvato o condiviso le informazioni sulle richieste.
Prompt.Title Titolo della richiesta fornita dall'utente durante il salvataggio o la condivisione della richiesta.
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 per il team.
Prompt.PublishedBy UPN dell'utente che ha pubblicato la richiesta al team.
Prompt.HydratedEntities Elenco di entità con informazioni su tipo ed entità.
Prompt.HydratedEntities.Type Attualmente sono supportati i tipi di entità People, File e Riunione.
Prompt.HydratedEntities.Entity Informazioni sull'entità in base al tipo di entità.
Prompt.HydratedEntities.Entity.Id ID univoco dell'entità.
Prompt.HydratedEntities.Entity.DisplayName Nome visualizzato dell'entità persona.
Prompt.HydratedEntities.Entity.EmailAddresses Elenco di indirizzi di posta elettronica per l'entità persona.
Prompt.HydratedEntities.Entity.ReferenceId ID univoco per il mapping della strumentazione.
Prompt.HydratedEntities.Entity.FileName Nome dell'entità file.
Prompt.HydratedEntities.Entity.AccessUrl URL di accesso dell'entità file.
Prompt.HydratedEntities.Entity.SpoId Identificatore del documento 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 Nome dell'organizzatore dell'evento
Prompt.HydratedEntities.Entity.OrganizerAddress Indirizzo dell'organizzatore dell'evento
Prompt.HydratedEntities.Entity.Attendees Elenco dei partecipanti dell'entità evento.

Informazioni sulla Raccolta prompt in Copilot

Gestisci i prompt pianificati per Microsoft Copilot

Gestire gli scenari di Microsoft Copilot nell'interfaccia di amministrazione di Microsoft 365