Set-HostedConnectionFilterPolicy

Modulo:
Exchange PowerShell

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

Default (Impostazione predefinita) 

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. 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-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 connessioni 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 da 10.10.10.0/25 e 172.17.17.0/24 sono 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 connessioni denominato Default con le impostazioni seguenti:

  • Gli indirizzi IP seguenti vengono aggiunti ai valori esistenti nell'elenco degli 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

Applicabile: Exchange Online, componente aggiuntivo di sicurezza predefinito per cassette postali locali

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

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

-ConfigurationXmlRaw

Applicabile: Exchange Online, componente aggiuntivo di sicurezza predefinito per cassette postali locali

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

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, componente aggiuntivo di sicurezza predefinito per cassette postali locali

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

-EnableSafeList

Applicabile: Exchange Online, componente aggiuntivo di sicurezza predefinito per cassette postali locali

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

Proprietà dei parametri

Tipo:Boolean
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, componente aggiuntivo di sicurezza predefinito per cassette postali locali

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

  • Nome
  • Nome distinto (DN)
  • GUID

In genere, è presente un solo criterio di filtro connessione: il criterio predefinito denominato Predefinito.

Proprietà dei parametri

Tipo:HostedConnectionFilterPolicyIdParameter
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

-IPAllowList

Applicabile: Exchange Online, componente aggiuntivo di sicurezza predefinito per cassette postali locali

Il parametro IPAllowList specifica gli indirizzi IP da cui i messaggi sono consentiti. I messaggi provenienti dagli indirizzi IP specificati non vengono identificati come posta indesiderata, nonostante le altre caratteristiche di posta indesiderata dei messaggi. I valori validi sono:

  • Singolo indirizzo IP: 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 CIDR (Classless InterDomain Routing): ad esempio, 192.168.0.1/25. I valori delle subnet mask validi 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 più indirizzi IP di tipi diversi contemporaneamente, è necessario utilizzare la seguente sintassi delle proprietà multivalore: @{Add="SingleIP1","IPRange1","CIDRIP1",...}.

Nota: gli intervalli IPv6 non sono supportati.

Proprietà dei parametri

Tipo:MultiValuedProperty
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

-IPBlockList

Applicabile: Exchange Online, componente aggiuntivo di sicurezza predefinito per cassette postali locali

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:

  • Singolo indirizzo IP: 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 CIDR (Classless InterDomain Routing): ad esempio, 192.168.0.1/25. I valori delle subnet mask validi 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 più indirizzi IP di tipi diversi contemporaneamente, è necessario utilizzare la seguente sintassi delle proprietà multivalore: @{Add="SingleIP1","IPRange1","CIDRIP1",...}.

Nota: gli intervalli IPv6 non sono supportati.

Proprietà dei parametri

Tipo:MultiValuedProperty
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

-MakeDefault

Applicabile: Exchange Online, componente aggiuntivo di sicurezza predefinito per cassette postali locali

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

Proprietà dei parametri

Tipo:SwitchParameter
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, componente aggiuntivo di sicurezza predefinito per cassette postali locali

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

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.

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.