Set-HostedConnectionFilterPolicy

Questo cmdlet è disponibile solamente nel servizio basato sul cloud.

Usare il cmdlet Set-HostedConnectionFilterPolicy per modificare le impostazioni dei criteri di filtro delle connessioni nell'organizzazione basata su cloud.

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

Sintassi

Set-HostedConnectionFilterPolicy
   [-Identity] <HostedConnectionFilterPolicyIdParameter>
   [-AdminDisplayName <String>]
   [-ConfigurationXmlRaw <String>]
   [-Confirm]
   [-EnableSafeList <Boolean>]
   [-IPAllowList <MultiValuedProperty>]
   [-IPBlockList <MultiValuedProperty>]
   [-MakeDefault]
   [-WhatIf]
   [<CommonParameters>]

Descrizione

È necessario disporre delle autorizzazioni prima di poter eseguire questo cmdlet. Sebbene in questo argomento vengano elencati tutti i parametri relativi al cmdlet, si potrebbe non avere accesso ad alcuni di essi qualora non siano 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-HostedConnectionFilterPolicy "Default" -IPAllowList 192.168.1.10,192.168.1.23 -IPBlockList 10.10.10.0/25,172.17.17.0/24

In questo esempio viene modificato il criterio del filtro di connessione denominato Default con le impostazioni seguenti:

  • Messaggi provenienti da 192.168.1.10 e da 192.168.1.23 non vengono mai identificati come posta indesiderata.
  • I messaggi della versione 10.10.10.0/25 e 172.17.17.0/24 vengono sempre identificati come posta indesiderata.

Esempio 2

Set-HostedConnectionFilterPolicy "Default" -IPAllowList @{Add="192.168.2.10","192.169.3.0/24","192.168.4.1-192.168.4.5"; Remove="192.168.1.10"}

In questo esempio viene modificato il criterio del filtro di connessione denominato Default con le impostazioni seguenti:

  • I seguenti indirizzi IP vengono aggiunti ai valori esistenti nell'elenco indirizzi IP consentiti: 192.168.2.10, 192.169.3.0/24 e 192.168.4.1-192.168.4.5.
  • L'indirizzo IP 192.168.1.10 viene rimosso dai valori esistenti nell'elenco indirizzi IP consentiti.

Parametri

-AdminDisplayName

Il parametro AdminDisplayName specifica una descrizione per i criteri. Se il valore contiene degli spazi, è necessario racchiuderlo tra virgolette ("). La lunghezza massima è di 255 caratteri.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-ConfigurationXmlRaw

Questo parametro è riservato all'uso interno da parte di Microsoft.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-Confirm

L'opzione Confirm consente di specificare se visualizzare o nascondere la richiesta di conferma. L'impatto di questa opzione sul cmdlet dipende dalla richiesta di conferma del cmdlet prima di procedere.

  • I cmdlet distruttivi , ad esempio i cmdlet Remove-*, hanno una pausa predefinita che impone 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 hanno una pausa predefinita. Per questi cmdlet, specificando l'opzione Confirm senza un valore viene introdotta una pausa che impone all'utente di confermare il comando prima di procedere.
Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-EnableSafeList

Il parametro EnableSafeList consente di abilitare o disabilitare l'elenco di sicurezza. L'elenco di sicurezza è un elenco dinamico di siti consentiti nel datacenter di Microsoft datacenter che non richiede la configurazione dell'utente. I valori validi sono:

$true: usare l'elenco sicuro per ignorare il filtro della posta indesiderata per i messaggi provenienti da mittenti attendibili identificati da varie origini di terze parti sottoscritte da Microsoft.

$false: non usare l'elenco sicuro. Questo è il valore predefinito.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-Identity

Il parametro Identity consente di specificare i criteri del filtro di connessione che si desidera modificare. È possibile utilizzare qualsiasi valore che identifichi il criterio in modo univoco. Ad esempio:

  • Nome
  • Nome distinto (DN)
  • GUID

In genere, si dispone di un solo criterio di filtro di connessione: il criterio predefinito denominato Default.

Type:HostedConnectionFilterPolicyIdParameter
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-IPAllowList

Il parametro IPAllowList specifica gli indirizzi IP da cui i messaggi sono consentiti. I messaggi provenienti dagli indirizzi IP specificati non verranno identificati come posta indesiderata, anche se i messaggi possiedono qualunque altra caratteristica di posta indesiderata. I valori validi sono:

  • Indirizzo IP singolo: ad esempio, 192.168.1.1.
  • Intervallo di indirizzi IP: è possibile usare un intervallo di indirizzi IP, ad esempio 192.168.0.1-192.168.0.254. Il numero massimo di indirizzi nell'intervallo è 256.
  • Intervallo di indirizzi IP CIDR (Classless InterDomain Routing): ad esempio, 192.168.0.1/25. I valori validi della subnet mask sono compresi tra /24 e /32.

È possibile indicare più indirizzi IP dello stesso tipo separati da virgole. Ad esempio, SingleIP1, SingleIP2,...SingleIPN o CIDRIP1,CIDRIP2,...CIDRIPN. Per specificare contemporaneamente più indirizzi IP di tipi diversi, è necessario usare la sintassi delle proprietà multivalore seguente: @{Add="SingleIP1","IPRange1","CIDRIP1",...}.

Nota: gli intervalli IPv6 non sono supportati.

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-IPBlockList

Il parametro IPBlockList specifica gli indirizzi IP da cui i messaggi non sono mai consentiti. I messaggi provenienti dagli indirizzi IP specificati vengono bloccati senza alcuna altra verifica di posta indesiderata. I valori validi sono:

  • Indirizzo IP singolo: ad esempio, 192.168.1.1.
  • Intervallo di indirizzi IP: è possibile usare un intervallo di indirizzi IP, ad esempio 192.168.0.1-192.168.0.254. Il numero massimo di indirizzi nell'intervallo è 256.
  • Intervallo di indirizzi IP CIDR (Classless InterDomain Routing): ad esempio, 192.168.0.1/25. I valori validi della subnet mask sono compresi tra /24 e /32.

È possibile indicare più indirizzi IP dello stesso tipo separati da virgole. Ad esempio, SingleIP1, SingleIP2,...SingleIPN o CIDRIP1,CIDRIP2,...CIDRIPN. Per specificare contemporaneamente più indirizzi IP di tipi diversi, è necessario usare la sintassi delle proprietà multivalore seguente: @{Add="SingleIP1","IPRange1","CIDRIP1",...}.

Nota: gli intervalli IPv6 non sono supportati.

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-MakeDefault

Questo parametro è riservato all'uso interno da parte di Microsoft.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-WhatIf

L'opzione WhatIf consente di simulare le azioni del comando. È possibile utilizzare tale opzione per visualizzare le modifiche che verrebbero applicate senza effettivamente applicarle. Con questa opzione non è necessario specificare alcun valore.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

Input

Input types

Per verificare i tipi di input accettati da questo cmdlet, vedere Tipi di input e output dei cmdlet. Se il campo relativo al tipo di input di un cmdlet è vuoto, il cmdlet non accetta dati di input.

Output

Output types

Per verificare i tipi restituiti, detti anche tipi di output, accettati da questo cmdlet, vedere Tipi di input e output dei cmdlet. Se il campo relativo al tipo di output è vuoto, il cmdlet non restituisce dati.