Set-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-28

Il cmdlet Set-IPBlockListProvider consente di modificare le informazioni di configurazione di un determinato provider dell'elenco Blocca indirizzi IP in un computer in cui è installato il ruolo del server Trasporto Edge o il ruolo del server Trasporto Hub.

Sintassi

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

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

Descrizione dettagliata

Il cmdlet Set-IPBlockListProvider consente di modificare le configurazioni esistenti del provider dell'elenco Blocca indirizzi IP. Questa configurazione viene utilizzata dall'agente Filtro connessioni. È necessario il parametro Identity.

Per eseguire il cmdlet Set-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 Set-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.

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
Identity	Obbligatorio	Microsoft.Exchange.Configuration.Tasks.IPBlockListProviderIdParameter	Il parametro Identity può accettare un valore di stringa corrispondente a Name o al GUID.
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 elenco indirizzi IP bloccati.
BitmaskMatch	Facoltativo	System.Net.IPAddress	Quando si configura un indirizzo IP per il parametro BitmaskMatch, l'agente Filtro connessioni agisce solo sui messaggi che corrispondono allo stesso codice di stato di indirizzo IP restituito dal servizio provider dell'elenco Blocca indirizzi IP.
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) del controller di dominio che consente di scrivere le modifiche alla configurazione nel servizio directory di Active Directory, includere nel comando il parametro DomainController. Il parametro DomainController non è supportato nei computer che eseguono 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.
Instance	Facoltativo	Microsoft.Exchange.Data.Directory.SystemConfiguration.IPBlockListProvider	Il parametro Instance consente di passare al comando l'intero oggetto per l'elaborazione. Viene utilizzato principalmente negli script in cui è necessario passare l'intero oggetto al comando.
IPAddressesMatch	Facoltativo	Microsoft.Exchange.Data.MultiValuedProperty	Quando si configura un indirizzo IP per il parametro IPAddressesMatch, l'agente Filtro connessioni agisce solo sui messaggi che corrispondono al codice di stato dell'indirizzo IP restituito dal servizio provider dell'elenco Blocca indirizzi IP.
LookupDomain	Facoltativo	Microsoft.Exchange.Data.SmtpDomain	Questo parametro specifica il nome di dominio richiesto dall'agente Filtro connessioni per i dati aggiornati dell'elenco Blocca indirizzi IP.
Name	Facoltativo	System.String	Questo parametro specifica il nome del servizio provider dell'elenco Blocca indirizzi IP. Il valore di stringa per il parametro Identity non cambia se si modifica questo valore.
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 Blocca indirizzi IP, 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 provider dell'elenco Blocca indirizzi IP, la priorità dell'altro provider 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 Blocca indirizzi IP 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 addresses matched to Example.com's IP Block List Provider service"`.
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

Gli esempi di codice seguenti mostrano due comandi Set-IPBlockListProvider.

Il primo esempio di codice mostra un comando Set-IPBlockListProvider che imposta il Filtro connessioni in modo tale da gestire ogni corrispondenza nel servizio provider dell'elenco Blocca indirizzi IP come evento processabile.

Il secondo esempio di codice mostra un comando Set-IPBlockListProvider che imposta la priorità di una configurazione esistente a 1.

Set-IPBlockListProvider -Identity Example.com -AnyMatch:$true 
Set-IPBlockListProvider -Identity Example.com -Priority 1