Add-IPAllowListProvider

 

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

Ultima modifica dell'argomento: 2007-06-22

Utilizzare il cmdlet Add-IPAllowListProvider per creare una nuova configurazione del provider dell'elenco Consenti indirizzi IP nel computer in cui è installato il ruolo del server Trasporto Edge o il ruolo del server Trasporto Hub.

Sintassi

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

Descrizione dettagliata

La configurazione del provider dell'elenco indirizzi IP consentiti 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-IPAllowListProvider, è 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-IPAllowListProvider in un computer nel quale è 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

LookupDomain

Obbligatorio

Microsoft.Exchange.Data.SmtpDomain

Nome di dominio richiesto dall'agente Filtro connessioni per informazioni aggiornate sull'elenco indirizzi IP consentiti.

Name

Obbligatorio

System.String

Nome del servizio provider dell'elenco indirizzi IP consentiti

AnyMatch

Facoltativo

System.Boolean

I valori validi per il parametro AnyMatch sono $true o $false. L'impostazione predefinita è $false. Se il parametro AnyMatch è impostato su $true, l'agente Filtro connessioni considera corrispondente qualsiasi codice di stato dell'indirizzo IP restituito dal servizio provider dell'elenco indirizzi IP consentiti.

BitmaskMatch

Facoltativo

System.Net.IPAddress

Se il parametro BitmaskMatch viene configurato per l'utilizzo di un indirizzo IP, l'agente Filtro connessioni opera solo sui messaggi che corrispondono al codice di stato dell'indirizzo IP restituito dal servizio provider dell'elenco indirizzi IP consentiti.

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 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 si esegue il comando 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 ADM locale.

Enabled

Facoltativo

System.Boolean

I valori validi per il parametro Enabled sono $true o $false. L'impostazione predefinita è $true. Se il parametro Enabled è impostato su $true, l'agente Filtro connessioni esegue una query al servizio provider dell'elenco indirizzi IP consentiti relativa alla priorità impostata per questa configurazione del provider dell'elenco indirizzi IP consentiti.

IPAddressesMatch

Facoltativo

Microsoft.Exchange.Data.MultiValuedProperty

Se un indirizzo IP viene configurato per il parametro IPAddressMatch, l'agente Filtro connessioni opera solo sui messaggi che corrispondono al codice di stato dell'indirizzo IP restituito dal servizio provider dell'elenco indirizzi IP consentiti.

Priority

Facoltativo

System.Int32

Impostare il parametro Priority per configurare l'ordine secondo il quale l'agente Filtro connessioni esegue la query ai servizi provider elenco indirizzi IP consentiti configurati. Per impostazione predefinita, ogni volta che viene aggiunto un nuovo servizio provider elenco indirizzi IP consentiti, alla voce viene assegnata una priorità N+1, dove N è il numero di servizi provider elenco indirizzi IP consentiti configurati.

Se il parametro Priority viene impostato sullo stesso valore di un altro servizio provider elenco indirizzi IP consentiti, la priorità del servizio provider elenco indirizzi IP consentiti aggiunto per primo viene incrementata di 1.

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. Per il parametro WhatIf non è necessario specificare un valore.

Tipi di input

Tipi restituiti

Errori

Errore Descrizione

 

 

Esempio

L'esempio di codice che segue mostra un comando Add-IPAllowListProvider che contiene i parametri obbligatori: LookupDomain e Name.

Add-IPAllowListProvider -Name:Example -LookupDomain:Example.com