Set-TeamsProtectionPolicy

Questo cmdlet è disponibile solamente nel servizio basato sul cloud.

Usare il cmdlet Set-TeamsProtectionPolicy per modificare i criteri di protezione di Microsoft Teams.

Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.

Sintassi

Default (Impostazione predefinita)

Set-TeamsProtectionPolicy
    [-Identity] <TeamsProtectionPolicyIdParameter>
    [-AdminDisplayName <String>]
    [-Confirm]
    [-HighConfidencePhishQuarantineTag <String>]
    [-MalwareQuarantineTag <String>]
    [-WhatIf]
    [-ZapEnabled <Boolean>]
    [<CommonParameters>]

Descrizione

È necessario disporre delle autorizzazioni prima di poter eseguire questo cmdlet. Anche se questo articolo elenca tutti i parametri per il cmdlet, si potrebbe non avere accesso ad alcuni parametri se non sono inclusi nelle autorizzazioni assegnate. Per individuare le autorizzazioni necessarie per eseguire cmdlet o parametri nell'organizzazione, vedere Trovare le autorizzazioni necessarie per eseguire i cmdlet di Exchange.

Esempio

Esempio 1

Set-TeamsProtectionPolicy -Identity "Teams Protection Policy" -HighConfidencePhishQuarantineTag AdminOnlyWithNotifications

In questo esempio vengono modificati i criteri di quarantena usati per i rilevamenti di phishing con alta attendibilità.

Parametri

-AdminDisplayName

Applicabile: Exchange Online

Il parametro AdminDisplayName consente di specificare una descrizione per il criterio. Se il valore contiene degli spazi, è necessario racchiuderlo tra virgolette (").

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Confirm

Applicabile: Exchange Online

L'opzione Confirm consente di specificare se visualizzare o nascondere la richiesta di conferma. Il modo in cui questa opzione influisce sul cmdlet varia se il cmdlet richiede o meno una conferma prima di procedere.

  • I cmdlet distruttivi (ad esempio, i cmdlet Remove-*) dispongono di una pausa incorporata che impone all'utente di confermare il comando prima di procedere. Per questi cmdlet, è possibile ignorare la richiesta di conferma usando questa precisa sintassi: -Confirm:$false.
  • La maggior parte degli altri cmdlet (ad esempio, i cmdlet New-* e Set-*) non dispone di una pausa incorporata. Per questi cmdlet, se si specifica l'opzione Confirm senza un valore, viene introdotta una pausa che impone di confermare il comando prima di procedere.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:cfr

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-HighConfidencePhishQuarantineTag

Applicabile: Exchange Online

Il parametro HighConfidencePhishQuarantineTag consente di specificare i criteri di quarantena usati per i messaggi in quarantena come phishing con alta attendibilità da ZAP per Teams. È possibile utilizzare qualsiasi valore che identifichi in modo univoco il criterio di quarantena. Ad esempio:

  • Nome
  • Nome distinto (DN)
  • GUID

I criteri di quarantena definiscono le operazioni che gli utenti possono eseguire per mettere in quarantena i messaggi e se gli utenti ricevono notifiche di quarantena. Per ulteriori informazioni sui criteri di quarantena, vedere Criteri di quarantena.

Se non si usa questo parametro, il criterio di quarantena predefinito in uso è denominato AdminOnlyAccessPolicy. Per ulteriori informazioni su questo criterio di quarantena, vedere Anatomia di un criterio di quarantena.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Identity

Applicabile: Exchange Online

Il parametro Identity consente di specificare i criteri di protezione di Teams che si desidera modificare. In un'organizzazione esiste un solo criterio di protezione di Teams denominato Criteri di protezione di Teams.

Proprietà dei parametri

Tipo:TeamsProtectionPolicyIdParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:1
Obbligatorio:True
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-MalwareQuarantineTag

Applicabile: Exchange Online

Il parametro MalwareQuarantineTag consente di specificare i criteri di quarantena usati per i messaggi messi in quarantena come malware da ZAP per Teams. È possibile utilizzare qualsiasi valore che identifichi in modo univoco il criterio di quarantena. Ad esempio:

  • Nome
  • Nome distinto (DN)
  • GUID

I criteri di quarantena definiscono le operazioni che gli utenti possono eseguire per mettere in quarantena i messaggi e se gli utenti ricevono notifiche di quarantena. Per ulteriori informazioni sui criteri di quarantena, vedere Criteri di quarantena.

Se non si usa questo parametro, il criterio di quarantena predefinito in uso è denominato AdminOnlyAccessPolicy. Per ulteriori informazioni su questo criterio di quarantena, vedere Anatomia di un criterio di quarantena.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-WhatIf

Applicabile: Exchange Online

L'opzione WhatIf mostra le operazioni eseguite dal comando senza apportare modifiche. Con questa opzione non è necessario specificare alcun valore.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:wi

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-ZapEnabled

Applicabile: Exchange Online

Il parametro ZapEnabled consente di specificare se abilitare l'eliminazione automatica zero ore (ZAP) per i malware e i messaggi di phishing con alta attendibilità nei messaggi di Teams. I valori validi sono:

  • $true: ZAP per i malware e i messaggi di phishing ad alta attendibilità in Teams è abilitato. Questo è il valore predefinito.
  • $false: ZAP per i malware e i messaggi di phishing con alta attendibilità in Teams è disabilitato.

Proprietà dei parametri

Tipo:Boolean
Valore predefinito:False
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedere about_CommonParameters.