Set-IPAllowListProvider

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

Utilizzare il cmdlet Set-IPAllowListProvider per modificare le informazioni di configurazione di un determinato provider dell'elenco Consenti indirizzi IP in un computer in cui è installato il ruolo del server Trasporto Edge o Trasporto Hub.

Sintassi

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

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

Descrizione dettagliata

Utilizzare il cmdlet Set-IPAllowListProvider per modificare le configurazioni esistenti del provider dell'elenco Consenti indirizzi IP. Questa configurazione viene utilizzata dall'agente Filtro connessioni. Il parametro Identity è obbligatorio.

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

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

Per eseguire il cmdlet Set-IPAllowListProvider in un computer in cui è installato il ruolo del server Trasporto Edge, è necessario accedere al sistema utilizzando un account che sia membro del 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.IPAllowListProviderIdParameter	Il parametro Identity può utilizzare un valore di stringa, ossia il valore di Name oppure il GUID.
AnyMatch	Facoltativo	System.Boolean	I valori validi per il parametro AnyMatch sono `$true` e `$false`. L'impostazione predefinita è `$false`. Quando il parametro AnyMatch è impostato su `$true`, l'agente Filtro connessioni tratta qualsiasi codice dello stato dell'indirizzo IP restituito dal servizio del provider dell'elenco indirizzi IP consentiti come una corrispondenza.
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 al codice dello stato dell'indirizzo IP restituito dal servizio del provider dell'elenco indirizzi IP consentiti.
Confirm	Facoltativo	System.Management.Automation.SwitchParameter	Il parametro Confirm consente di determinare la sospensione dell'elaborazione e di richiedere che l'utente confermi l'operazione che verrà eseguita dal comando prima che l'elaborazione continui. Con il parametro Confirm non è necessario specificare un valore.
DomainController	Facoltativo	Microsoft.Exchange.Data.Fqdn	Per specificare quale controller di dominio scrive la modifica alla configurazione dei dati di configurazione del filtro connessioni nel servizio directory di Active Directory, includere nel comando il parametro DomainController. Se il comando viene eseguito in un computer in cui è installato il ruolo del server Trasporto Edge, il parametro DomainController non è supportato. Il server Trasporto Edge scrive solo sull'istanza ADAM locale.
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 al servizio del provider dell'elenco di indirizzi IP consentiti in base alla priorità impostata per la configurazione del provider dell'elenco indirizzi IP consentiti.
Instance	Facoltativo	Microsoft.Exchange.Data.Directory.SystemConfiguration.IPAllowListProvider	Il parametro Instance consente di trasmettere l'intero oggetto al comando 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 dello stato dell'indirizzo IP restituito dal servizio del provider dell'elenco indirizzi IP consentiti.
LookupDomain	Facoltativo	Microsoft.Exchange.Data.SmtpDomain	Il nome di dominio per il quale l'agente Filtro connessioni esegue una query per i dati aggiornati dell'elenco indirizzi IP consentiti.
Name	Facoltativo	System.String	Il nome del servizio del provider dell'elenco indirizzi IP consentiti. Il valore di stringa del parametro Identity non viene modificato se si modifica questo valore.
Priority	Facoltativo	System.Int32	Impostare il parametro Priority per configurare l'ordine in cui l'agente Filtro connessioni esegue la query al servizio del provider dell'elenco indirizzi IP consentiti configurato. Per impostazione predefinita, ogni volta che si aggiunge un nuovo servizio del provider dell'elenco indirizzi IP consentiti, alla voce viene assegnata la priorità N+1, dove N è il numero dei servizi del provider dell'elenco indirizzi IP consentiti configurato. Se si imposta il parametro Priority su un valore uguale al valore di un altro servizio del provider dell'elenco di indirizzi IP consentiti, la priorità del servizio del provider dell'elenco indirizzi IP consentiti aggiunto per primo viene incrementata di 1.
WhatIf	Facoltativo	System.Management.Automation.SwitchParameter	Il parametro WhatIf consente di indicare al comando di simulare le azioni da intraprendere sull'oggetto. Il parametro WhatIf consente di visualizzare le modifiche che verrebbero apportate senza applicarle. Con il parametro WhatIf non è necessario specificare un valore.

Tipi di input

Tipi restituiti

Errori

Errore	Descrizione

Esempio

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

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

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