Panoramica delle esclusioni di dominio

Utilizzando l'esclusione di dominio, è possibile specificare fino a 1.000 siti da escludere dal Web grounding in Microsoft Copilot e Copilot Chat tramite uno script PowerShell.

Per gestire la configurazione dell'esclusione di dominio Copilot per il tenant, usare lo script ConfigureTenantDomainExclusions.ps1 PowerShell. Scaricalo all'indirizzo https://aka.ms/Copilot/DomainExclusionScript. Attualmente, la configurazione dell'esclusione di dominio supporta fino a due livelli di sottodomini.

Questo script offre le funzionalità seguenti:

• Ottenere la configurazione corrente dell'esclusione di dominio ed esportarla in formato CSV
• Creare una nuova configurazione di esclusione di dominio da file CSV
• Aggiornare una configurazione di esclusione di dominio esistente dal file CSV
• Eliminare la configurazione corrente di esclusione di dominio
• Generare un file CSV di modello per le esclusioni di domini

Le impostazioni predefinite non includono la configurazione di esclusione del dominio. Acconsentire esplicitamente all'uso della funzionalità eseguendo lo script di PowerShell.

Prerequisiti

Prima di eseguire lo script, accertarsi di soddisfare i requisiti seguenti:

• Autorizzazioni amministrative:

  • Accedere come amministratore della ricerca o amministratore globale.
  • Vedere Informazioni sui ruoli di amministratore nell'interfaccia di amministrazione di Microsoft 365.

• Requisiti di PowerShell:

  • Windows PowerShell 5.1 o PowerShell 7+. (Vedi Introduzione a PowerShell 101)
  • Az.Accounts modulo di PowerShell (lo ConfigureTenantDomainExclusions.ps1 script installa automaticamente il modulo se manca).
  • Criteri di esecuzione impostati per consentire l'esecuzione di script (vedere Errori dei criteri di esecuzione).

• Requisiti del file CSV (per le operazioni di creazione/aggiornamento):

  • Massimo 1.000 voci per file CSV.
  • Colonne obbligatorie: Domain, IncludeSubPages.
  • I valori di dominio devono essere domini o URL validi (ad esempio, https://www.example.org).
  • IncludeSubPages i valori devono essere booleani (True/False).
  • Consulta Generare un modello CSV (in questo articolo).

Scaricare lo script di PowerShell Configura esclusioni domini tenant

1. Scaricare il file Configure Tenant Domain Exclusions PowerShell all'indirizzo https://aka.ms/Copilot/DomainExclusionScript.

2. Decomprimerlo in una posizione accessibile da PowerShell.

Configurare l'esclusione di dominio tramite PowerShell

Durante l'esecuzione di ogni comando, viene richiesto di eseguire l'accesso. Il sistema recupera le sottoscrizioni del tenant, esegue l'operazione e quindi visualizza la conferma che l'operazione è stata completata correttamente.

Generare un modello CSV

Creare un modello di file CSV per iniziare:

   .\ConfigureTenantDomainExclusions.ps1 -Template

Esempio di contenuto CSV

Negli esempi seguenti, il contenuto CSV di esempio è rappresentato da un dominio seguito da un valore booleano che determina se includere le sottopagine del dominio:

<Domain>,<IncludeSubPages value>

https://www.example.org,True

example.com,False

https://docs.contoso.com,True

Ottenere la configurazione corrente

Esportare la configurazione corrente dell'esclusione di dominio in un file CSV:

   .\ConfigureTenantDomainExclusions.ps1 -Get

Per impostazione predefinita, lo script esporta in domain_exclusions.csv. Per esportare in un file specifico, specificare il nome desiderato utilizzando -ToFile e specificando il nome del file come illustrato nell'esempio seguente:

   .\ConfigureTenantDomainExclusions.ps1 -Get -ToFile "yourfilename.csv"

Creare una nuova configurazione

Creare la configurazione dell'esclusione di dominio da un file CSV:

   .\ConfigureTenantDomainExclusions.ps1 -Create -FromFile "input.csv"

Aggiornare una configurazione esistente

Aggiornare la configurazione corrente dell'esclusione di dominio con le voci di un file CSV:

   .\ConfigureTenantDomainExclusions.ps1 -Update -FromFile "updated_domains.csv"

Eliminare una configurazione

Rimuovere la configurazione corrente dell'esclusione di dominio:

   .\ConfigureTenantDomainExclusions.ps1 -Delete

Formato di file CSV

Quando si creano o si aggiornano le esclusioni di dominio, il file CSV deve includere le colonne seguenti:

Problemi comuni e risoluzione dei problemi

Limitazioni

Attualmente, le esclusioni di dominio supportano il filtro solo sui risultati delle pagine Web. I risultati di altri verticali di risposta, come le notizie, potrebbero comunque essere citati.

Errori dei criteri di esecuzione

Se ricevi un errore sui criteri di esecuzione quando tenti di eseguire lo script, potrebbe essere necessario impostare temporaneamente i criteri di esecuzione su Unrestricted:

Set-ExecutionPolicy -Scope Process -ExecutionPolicy Unrestricted

Per altre informazioni sui criteri di esecuzione di PowerShell, vedere la documentazione relativa ai criteri di esecuzione di PowerShell.

Problemi di autenticazione

Se si verificano errori di autenticazione:

1. Assicurarsi di aver eseguito l'accesso come amministratore della ricerca o amministratore globale.

2. Provare a disconnettere e riconnettere l'account di Azure.

   powershell Disconnect -AzAccount Connect -AzAccount
   

Errori di convalida del file CSV

Se si ricevono errori di convalida CSV, controllare questi elementi:

• Domini non validi: assicurati che tutte le voci del dominio siano URL o nomi di dominio validi.
• Colonne mancanti: verificare che il file CSV contenga entrambe le Domain colonne e IncludeSubPages .
• Troppe voci: assicurati che il tuo CSV non contenga più di 1.000 voci.
• Valori booleani: assicurati di IncludeSubPages contenere solo True valori or False .

Contenuti correlati

Per altre informazioni sui criteri di esecuzione di PowerShell, vedere Informazioni sui criteri di esecuzione.