Set-IPAllowListProvider
Questo cmdlet è disponibile o efficace solo nei server Trasporto Edge in Exchange locale.
Usare il cmdlet Set-IPAllowListProvider per modificare provider dell'elenco indirizzi IP consentiti utilizzati dall'agente filtro connessioni su server Trasporto Edge.
Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.
Sintassi
Set-IPAllowListProvider
[-Identity] <IPAllowListProviderIdParameter>
[-AnyMatch <Boolean>]
[-BitmaskMatch <IPAddress>]
[-Confirm]
[-DomainController <Fqdn>]
[-Enabled <Boolean>]
[-IPAddressesMatch <MultiValuedProperty>]
[-LookupDomain <SmtpDomain>]
[-Name <String>]
[-Priority <Int32>]
[-WhatIf]
[<CommonParameters>]
Descrizione
Sui server Trasporto Edge, è necessario essere membri del gruppo di amministratori locale per eseguire questo cmdlet.
Esempio
Esempio 1
Set-IPAllowListProvider Contoso.com -AnyMatch $true
In questo esempio viene configurato il provider dell'elenco indirizzi IP consentiti denominato Contoso.com per consentire le connessioni da un indirizzo IP se vengono restituiti codici di stato degli indirizzi IP.
Esempio 2
Set-IPAllowListProvider Contoso.com -Priority 1
In questo esempio viene impostata la priorità su 1 per il provider dell'elenco indirizzi IP consentiti esistente denominato Contoso.com.
Parametri
-AnyMatch
Il parametro AnyMatch specifica se le risposte dal provider dell'elenco di indirizzi consentiti vengono trattate come una corrispondenza. L'input valido per questo parametro è $true o $false. Il valore predefinito è $false. Quando questo parametro è impostato su $true e il filtro connessioni invia l'indirizzo IP del server SMTP di connessione al provider dell'elenco di indirizzi consentiti, i codici di risposta restituiti dal provider dell'elenco di indirizzi consentiti fa sì che il filtro connessioni consenta i messaggi da quell'origine.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-BitmaskMatch
Il parametro BitmaskMatch specifica il codice di stato della maschera di bit restituito dal provider dell'elenco di indirizzi consentiti. Utilizzare questo parametro se il provider dell'elenco di indirizzi consentiti restituisce le risposte della maschera di bit. L'input valido per questo parametro è un singolo indirizzo IP nel formato 127.0.0.1.
Type: | IPAddress |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-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 Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-DomainController
Il parametro DomainController consente di specificare il controller di dominio utilizzato da questo cmdlet per la lettura o la scrittura dei dati in Active Directory. Identificare il controller di dominio mediante il relativo nome di dominio completo (FQDN). Ad esempio, dc01.contoso.com.
Il parametro DomainController non è supportato sui server Trasporto Edge. Un server Trasporto Edge usa l'istanza locale di Active Directory Lightweight Directory Services (AD LDS) per leggere e scrivere i dati.
Type: | Fqdn |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Enabled
Il parametro Enabled consente di specificare se l'agente filtro connessioni esegue una query sul provider dell'elenco indirizzi IP consentiti in base alla priorità impostata per la configurazione del provider dell'elenco indirizzi IP consentiti. L'input valido per questo parametro è $true o $false. Il valore predefinito è $true. Per impostazione predefinita, l'agente filtro connessioni esegue una query sul provider dell'elenco indirizzi IP consentiti in base alla priorità impostata per la configurazione del provider dell'elenco indirizzi IP consentiti.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Identity
Il parametro Identity consente di specificare il provider dell'elenco indirizzi IP consentiti che si desidera modificare. È possibile utilizzare qualsiasi che consenta di identificare in modo univoco il provider dell'elenco indirizzi IP consentiti. Ad esempio:
- Nome
- Nome distinto (DN)
- GUID
Type: | IPAllowListProviderIdParameter |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-IPAddressesMatch
Il parametro IPAddressesMatch specifica i codici di stato degli indirizzi IP restituiti dal provider dell'elenco consentiti. Usare questo parametro se il provider dell'elenco di indirizzi consentiti restituisce l'indirizzo IP o le risposte a un record. Input valido per questo parametro uno o più indirizzi IP nel formato 127.0.0.1.
Per immettere più valori e sovrascrivere le voci esistenti, usare la sintassi seguente: Value1,Value2,...ValueN
. Se i valori contengono spazi o altrimenti richiedono virgolette, usare la sintassi seguente: "Value1","Value2",..."ValueN"
.
Per aggiungere o rimuovere uno o più valori senza influire sulle voci esistenti, usare la sintassi seguente: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}
.
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-LookupDomain
Il parametro LookupDomain specifica il nome host necessario per utilizzare il provider elenco indirizzi consentiti. Il filtro connessioni invia l'indirizzo IP del server SMTP di connessione al valore del nome host specificato. Un valore di esempio è allowlist.spamservice.com. Il valore effettivo necessario da utilizzare viene fornito dal provider elenco indirizzi consentiti.
Type: | SmtpDomain |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Name
Il parametro Name consente di specificare il nome del provider dell'elenco indirizzi IP consentiti.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Priority
Il parametro Priority consente di specificare l'ordine in cui l'agente di filtro connessioni esegue una query sui provider dell'elenco indirizzi IP consentiti configurati. Per impostazione predefinita, ogni volta che si aggiunge un nuovo provider dell'elenco indirizzi IP consentiti, alla voce viene assegnata la priorità N+1, dove N è il numero di provider dell'elenco indirizzi IP consentiti configurati.
Se si imposta il parametro Priority su un valore uguale a un altro provider dell'elenco indirizzi IP consentiti, la priorità del provider dell'elenco indirizzi IP consentiti aggiunto per primo viene incrementata di 1.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-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 Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
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.