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.