Set-RecipientFilterConfig

 

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

Ultima modifica dell'argomento: 2009-05-18

Utilizzare il cmdlet Set-RecipientFilterConfig per abilitare e configurare l'agente Filtro destinatario di un computer in cui è installato il ruolo server Trasporto Edge o Trasporto Hub.

Sintassi

Set-RecipientFilterConfig [-BlockedRecipients <MultiValuedProperty>] [-BlockListEnabled <$true | $false>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Enabled <$true | $false>] [-ExternalMailEnabled <$true | $false>] [-Instance <RecipientFilterConfig>] [-InternalMailEnabled <$true | $false>] [-RecipientValidationEnabled <$true | $false>] [-WhatIf [<SwitchParameter>]]

Descrizione dettagliata

Per eseguire il cmdlet Set-RecipientFilterConfig, è 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-RecipientFilterConfig 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

BlockedRecipients

Facoltativo

Microsoft.Exchange.Data.MultiValuedProperty

I valori validi per il parametro BlockedRecipients Enabled sono uno o più indirizzi SMTP. È possibile immettere fino a 800 indirizzi SMTP per il parametro BlockedRecipients.

BlockListEnabled

Facoltativo

System.Boolean

I valori validi per il parametro BlockListEnabled Enabled sono $true o $false. L'impostazione predefinita è $false. Se il parametro BlockListEnabled è impostato su $true, i messaggi inviati ai destinatari elencati nel parametro BlockedRecipients vengono bloccati dall'agente Filtro destinatario.

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 il nome di dominio completo (FQDN) 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 viene eseguito il ruolo del server Edge Transport. Il ruolo del server Edge Transport 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. Se il parametro Enabled è impostato su $true, nel computer su cui si esegue il cmdlet Set-RecipientFilterConfig viene abilitato l'agente Filtro destinatario.

ExternalMailEnabled

Facoltativo

System.Boolean

I valori validi per il parametro ExternalMailEnabled sono $true o $false. L'impostazione predefinita è $true. Se il parametro ExternalMailEnabled è impostato su $true, tutti i messaggi provenienti da connessioni non autenticate vengono passati all'agente Filtro destinatario per l'elaborazione.

Instance

Facoltativo

Microsoft.Exchange.Data.Directory.SystemConfiguration.RecipientFilterConfig

Il parametro Instance consente di passare l'intero oggetto al comando per l'elaborazione. Viene utilizzato principalmente negli script in cui è necessario passare l'intero oggetto al comando.

InternalMailEnabled

Facoltativo

System.Boolean

I valori validi per il parametro InternalMailEnabled sono $true o $false. L'impostazione predefinita è $false. Se il parametro InternalMailEnabled è impostato su $true, tutti i messaggi provenienti da domini mittente autenticati appartenenti a domini autorevoli dell'organizzazione vengono passati all'agente Filtro destinatario per l'elaborazione.

RecipientValidationEnabled

Facoltativo

System.Boolean

I valori validi per il parametro RecipientValidationEnabled Enabled sono $true o $false. L'impostazione predefinita è $false. Se il parametro RecipientValidationEnabled è impostato su $true, i messaggi che contengono destinatari inesistenti nell'organizzazione vengono bloccati dall'agente Filtro destinatario.

WhatIf

Facoltativo

System.Management.Automation.SwitchParameter

Il parametro WhatIf consente di indicare al comando di simulare le azioni da eseguire 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

Nei seguenti codici di esempio sono mostrati due comandi Set-RecipientFilterConfig.

Nel primo esempio viene illustrato come modificare la configurazione di Filtro destinatario in modo da abilitare la convalida del destinatario.

Nel secondo esempio viene illustrato come abilitare l'elenco dei destinatari bloccati e come aggiungere destinatari a questo elenco.

Il parametro BlockedRecipients assume diversi valori. Se si passa un valore al parametro BlockedRecipients, il valore esistente viene sostituito da quello nuovo. Per ulteriori informazioni su come aggiungere o rimuovere valori dalle proprietà multivalore, vedere Modifica delle proprietà multivalore.

Set-RecipientFilterConfig -RecipientValidationEnabled:$true
Set-RecipientFilterConfig -BlockListEnabled:$true -BlockedRecipients user1@contoso.com,user2@contoso.com