Modificare le modalità information barriers con uno script di PowerShell

Usare questo script di PowerShell per aggiornare la modalità Information Barriers (IB) per tutti i gruppi connessi a Teams nel tenant. È necessario aggiornare la modalità per questi gruppi dopo aver distribuito le barriere informative. Ai gruppi creati prima di abilitare IB viene assegnata la modalità Apri . In modalità Aperta non sono presenti criteri IB applicabili. Dopo aver abilitato IB, Implicit diventa la modalità predefinita per tutti i nuovi gruppi creati. Tuttavia, i gruppi esistenti mantengono la configurazione in modalità Aperta . Eseguire questo script per modificare questi gruppi esistenti in modalità implicita .

In questo script si usa il cmdlet Get-UnifiedGroup, che si trova nel modulo Exchange Online PowerShell per aggiornare la modalità. Per altre informazioni sulla gestione di Teams tramite PowerShell, vedere Panoramica di Teams PowerShell.

Prerequisiti

Prima di eseguire questo script, assicurarsi di disporre dei prerequisiti seguenti:

• Il modulo Exchange Online PowerShell installato.
• Un account aziendale o dell'istituto di istruzione con il ruolo di amministratore globale per il tenant.

Eseguire lo script

Completare la procedura seguente per aggiornare la modalità IB per tutti i gruppi connessi a Teams esistenti:

1. Connettersi a Exchange Online PowerShell:

   Connect-ExchangeOnline
   

2. Copiare ed eseguire lo script seguente. Lo script identifica tutti i gruppi connessi a Teams in modalità Aperta e li aggiorna alla modalità implicita .

3. Al termine dello script, esaminare l'output per il numero di gruppi aggiornati correttamente. Se non è possibile aggiornare i gruppi, controllare il BackfillFailedTeams.csv file generato nella directory corrente per informazioni dettagliate e riprovare i gruppi non riusciti.

Script di esempio

<#
.SYNOPSIS
This script updates the IB mode for all Teams-connected groups in your tenant at the same time.
.DESCRIPTION
Use this script to update the info barrier mode from open to implicit across the groups in your tenant.
#>

$teams = Get-UnifiedGroup -Filter {ResourceProvisioningOptions -eq "Team"} -ResultSize Unlimited

Write-Output ([string]::Format("Number of Teams = {0}", @($teams).Length))

$teamsToUpdate = New-Object System.Collections.ArrayList

foreach($team in $teams)
{
  if ($team.InformationBarrierMode -eq "Open")
  {
    $teamsToUpdate.Add($team.ExternalDirectoryObjectId) | out-null
  }
}

Write-Output ([string]::Format("Number of Teams to be backfilled = {0}", @($teamsToUpdate).Length))

$outfile = "BackfillFailedTeams.csv"

if (!(Test-Path "$outfile"))
{
  $newcsv = {} | Select "ExternalDirectoryObjectId", "ExceptionDetails" | Export-Csv $outfile -NoTypeInformation
}
else
{
  $dateTime = Get-Date
  $newEntry = "{0},{1}" -f "New session started", $dateTime
  $newEntry | add-content $outfile
}

$SuccessfullyBackfilledGroup = 0

for($i = 0; $i -lt @($teamsToUpdate).Length; $i++)
{
  Invoke-Command { Set-UnifiedGroup $teamsToUpdate[$i] -InformationBarrierMode "Implicit" } -ErrorVariable ErrorOutput

  if ($ErrorOutput)
  {
    # saving the errors in a csv file
    $errorBody = $ErrorOutput[0].ToString() -replace "`n"," " -replace "`r"," " -replace ",", " "
    $newEntry = "{0},{1}" -f $teamsToUpdate[$i].ToString(), '"' + $errorBody + '"'
    $newEntry | add-content $outfile
  }
  else
  {
    $SuccessfullyBackfilledGroup++
  }

  if (($i+1) % 100 -eq 0)
  {
    # print the number of teams backfilled after the batch of 100 updates
    Write-Output ([string]::Format("Number of Teams processed= {0}", $i+1))
  }
}

Write-Output ([string]::Format("Backfill completed. Groups backfilled: {0}, Groups failed to backfill: {1}", $SuccessfullyBackfilledGroup, @($teamsToUpdate).Length - $SuccessfullyBackfilledGroup))

if (!($SuccessfullyBackfilledGroup -eq @($teamsToUpdate).Length))
{
  Write-Output ([string]::Format("Check the failed teams in BackfillFailedTeams.csv, retry to backfill the failed teams."))
}

Risorse

• Informazioni sulle barriere informative
• Introduzione alle barriere informative
• Barriere informative in Microsoft Teams