Add-IPBlockListProvider

Articolo
08/07/2014

Si applica a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Ultima modifica dell'argomento: 2007-06-22

Il cmdlet Add-IPBlockListProvider consente di creare una nuova configurazione del provider dell'elenco Blocca indirizzi IP nel computer in cui è installato il ruolo del server Trasporto Edge o Trasporto Hub.

Sintassi

Add-IPBlockListProvider -Name <String> -LookupDomain <SmtpDomain> [-AnyMatch <$true | $false>] [-BitmaskMatch <IPAddress>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Enabled <$true | $false>] [-IPAddressesMatch <MultiValuedProperty>] [-Priority <Int32>] [-RejectionResponse <AsciiString>] [-TemplateInstance <PSObject>] [-WhatIf [<SwitchParameter>]]

Descrizione dettagliata

La configurazione del provider dell'elenco di indirizzi IP bloccati viene utilizzata dall'agente filtro connessioni.

Sono obbligatori i parametri Name e LookupDomain. Se non vengono passati, i parametri obbligatori verranno richiesti da Exchange Management Shell.

Per eseguire il cmdlet Add-IPBlockListProvider, è necessario utilizzare un account che disponga della seguente delega:

Ruolo Exchange Server Administrator e appartenenza al gruppo Administrators locale del server di destinazione.

Per eseguire il cmdlet Add-IPBlockListProvider in un computer in cui è installato il ruolo del server Trasporto Edge, è necessario accedere al sistema utilizzando un account appartenente al gruppo Administrators locale del computer in questione.

Per ulteriori informazioni sulle autorizzazioni, sulla delega dei ruoli e sui diritti necessari per l'amministrazione di Microsoft Exchange Server 2007, vedere Considerazioni sulle autorizzazioni.

Parametri

Parametro	Obbligatorio	Tipo	Descrizione
LookupDomain	Obbligatorio	Microsoft.Exchange.Data.SmtpDomain	Nome di dominio richiesto dall'agente Filtro connessioni per i dati aggiornati dell'elenco di indirizzi IP bloccati
Name	Obbligatorio	System.String	Nome del servizio provider dell'elenco di indirizzi IP bloccati
AnyMatch	Facoltativo	System.Boolean	I valori validi per il parametro Enabled sono `$true` o `$false`. L'impostazione predefinita è `$false`. Quando il parametro AnyMatch è impostato su `$true`, l'agente filtro connessioni considera come corrispondenza qualsiasi codice di stato di indirizzo IP restituito dal servizio provider dell'elenco di indirizzi IP bloccati.
BitmaskMatch	Facoltativo	System.Net.IPAddress	Quando si configura il parametro BitmaskMatch per l'utilizzo di un indirizzo IP, l'agente Filtro connessioni agisce solo sui messaggi che corrispondono al codice di stato di indirizzo IP restituito dal servizio provider dell'elenco di indirizzi IP bloccati.
Confirm	Facoltativo	System.Management.Automation.SwitchParameter	Il parametro Confirm determina l'interruzione dell'elaborazione e richiede che l'utente, prima che l'elaborazione continui, confermi l'operazione che verrà eseguita dal comando. Non è necessario specificare alcun valore con il parametro Confirm.
DomainController	Facoltativo	Microsoft.Exchange.Data.Fqdn	Per specificare il nome di dominio completo (FQDN, fully qualified domain name) del controller di dominio che consente di scrivere la modifica alla configurazione nel servizio directory di Active Directory, includere nel comando il parametro DomainController. Il parametro DomainController non è supportato nei computer in cui è installato il ruolo del server Trasporto Edge. Il ruolo del server Trasporto Edge prevede solo la scrittura nell'istanza locale ADAM.
Enabled	Facoltativo	System.Boolean	I valori validi per il parametro Enabled sono `$true` o `$false`. L'impostazione predefinita è `$true`. Quando il parametro Enabled è impostato su `$true`, l'agente filtro connessioni esegue una query sul servizio provider dell'elenco di indirizzi IP bloccati in base alla priorità impostata per questa configurazione del provider in questione.
IPAddressesMatch	Facoltativo	Microsoft.Exchange.Data.MultiValuedProperty	Quando il parametro IPAddressesMatch è configurato per l'utilizzo di un indirizzo IP, l'agente Filtro connessioni agisce solo sui messaggi che corrispondono allo stesso codice di stato di indirizzo IP restituito dal servizio provider dell'elenco di indirizzi IP bloccati.
Priority	Facoltativo	System.Int32	Impostare il parametro Priority per configurare l'ordine con cui l'agente filtro connessioni esegue query sui servizi provider dell'elenco di indirizzi IP bloccati configurati. Per impostazione predefinita, ogni volta che si aggiunge un nuovo provider dell'elenco di indirizzi IP bloccati, alla voce viene assegnata una priorità pari a N+1, dove N corrisponde al numero di servizi provider configurati. Se si imposta il parametro Priority su un valore identico a quello di un altro servizio provider dell'elenco di indirizzi IP bloccati, la priorità del provider dell'elenco di indirizzi IP bloccati aggiunto per primo viene incrementata di un'unità.
RejectionResponse	Facoltativo	Microsoft.Exchange.Data.AsciiString	Il parametro RejectionResponse utilizza una stringa. Immettere il corpo del messaggio che si desidera sia recapitato nella sessione SMTP ai mittenti i cui messaggi vengono bloccati dall'agente filtro connessioni quando l'indirizzo IP del mittente corrisponde a un indirizzo del servizio provider dell'elenco di indirizzi IP bloccati. È consigliabile specificare il servizio provider dell'elenco di indirizzi IP bloccati nella risposta, in modo che possa essere contattato dai mittenti autorizzati. L'argomento non può superare i 240 caratteri. Quando si invia un argomento, è necessario racchiudere il parametro RejectionResponse tra virgolette doppie se la frase contiene spazi come nel seguente esempio: `"Originating IP addressed matched to Example.com's IP Block List provider service"`.
TemplateInstance	Facoltativo	System.Management.Automation.PSObject	Quando per questo parametro viene specificato un oggetto esistente, il comando utilizza la configurazione dell'oggetto per crearne un duplicato esatto in un server locale o di destinazione.
WhatIf	Facoltativo	System.Management.Automation.SwitchParameter	Il parametro WhatIf consente al comando di simulare le azioni da intraprendere sull'oggetto. Utilizzando il parametro WhatIf, è possibile visualizzare quali sono le modifiche che verrebbero apportate senza applicarle. Non è necessario specificare alcun valore con il parametro WhatIf.

Tipi di input

Tipi restituiti

Errori

Errore	Descrizione

Esempio

Nel primo esempio di codice è mostrato un comando Add-IPBlockListProvider che contiene i parametri obbligatori. Viene inoltre illustrato come aggiungere un nuovo provider dell'elenco Blocca indirizzi IP e impostare una risposta di rifiuto.

Nel secondo esempio di codice viene mostrato un comandoAdd-IPBlockListProvider che ha i parametri richiesti e illustra come configurare un valore restituito della maschera di bit dal provider.

Add-IPBlockListProvider -Name:Example -LookupDomain:Example.com -RejectionResponse "Originating IP addressed matched to Example.com's IP Block List provider service"
Add-IPBlockListProvider -Name:Example -LookupDomain:Example.com -BitmaskMatch 127.1.0.1