Add-IPAllowListEntry

 

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

Ultima modifica dell'argomento: 2007-07-06

Utilizzare il cmdlet Add-IPAllowListEntry per aggiungere un indirizzo IP o un intervallo di indirizzi IP alle informazioni di configurazione dell'elenco di indirizzi IP consentiti per l'agente Filtro connessioni in un computer in cui è installato il ruolo server Trasporto Hub o il ruolo server Trasporto Edge.

Sintassi

Add-IPAllowListEntry -IPRange <IPRange> [-Comment <String>] [-Confirm [<SwitchParameter>]] [-ExpirationTime <DateTime>] [-Server <ServerIdParameter>] [-WhatIf [<SwitchParameter>]]

Add-IPAllowListEntry -IPAddress <IPAddress> [-Comment <String>] [-Confirm [<SwitchParameter>]] [-ExpirationTime <DateTime>] [-Server <ServerIdParameter>] [-WhatIf [<SwitchParameter>]]

Descrizione dettagliata

Se non si specifica il parametro IPAddress quando si esegue il cmdlet Add-IPAllowListEntry, in Exchange Management Shell viene visualizzato un messaggio in cui viene chiesto di eseguire tale operazione. È obbligatorio includere il parametro IPAddress o il parametro IPRange.

Nota

Se Microsoft Exchange Server 2007 Service Pack 1 (SP1) viene distribuito in un computer che esegue Windows Server 2008, è possibile immettere gli indirizzi IP e gli intervalli di indirizzi IP nel formato IPv4 (Internet Protocol Version 4), nel formato IPv6 (Internet Protocol Version 6), o in entrambi i formati. L'installazione predefinita di Windows Server 2008 abilita il supporto per i formati IPv4 e IPv6. Per ulteriori informazioni sul supporto di Exchange 2007 SP1 per gli indirizzi in formato IPv6, vedere Supporto IPv6 in Exchange 2007 SP1 e SP2.

Per eseguire il cmdlet Add-IPAllowListEntry, è 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 Add-IPAllowListEntry in un computer in cui è installato il ruolo 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

IPAddress

Obbligatorio

System.Net.IPAddress

È possibile specificare un singolo indirizzo IP da aggiungere all'elenco di indirizzi IP consentiti, ad esempio: 192.168.0.1.

IPRange

Obbligatorio

Microsoft.Exchange.Data.IPRange

È possibile aggiungere intervalli di indirizzi IP all'elenco di indirizzi IP consentiti nei seguenti formati:

  • IP CIDR    Classless InterDomain Routing. Ad esempio, 192.168.0.1/24

  • Intervallo di indirizzi IP   Ad esempio, 192.168.0.1-192.168.0.254

Comment

Facoltativo

System.String

Utilizzare questo parametro per creare note o promemoria amministrativi relativi a questa voce specifica. È necessario racchiudere il valore del parametro Comment tra virgolette doppie, come nel seguente esempio: "questa è una nota amministrativa".

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.

ExpirationTime

Facoltativo

System.DateTime

È possibile specificare il giorno e l'ora della scadenza della voce dell'elenco di indirizzi IP consentiti che si sta creando. Se si specifica un'ora ma non si specifica alcuna data, sarà considerata valida la data corrente. Quando si immette una data specifica, utilizzare il formato data breve definito nelle impostazioni delle opzioni internazionali configurate nel computer locale. Ad esempio, se il computer è configurato per utilizzare il formato data breve mm/dd/yyyy hh:mm:ss, per impostare l'ora di scadenza alle 11:00 del 3 gennaio 2007, immettere le seguenti informazioni racchiuse tra virgolette doppie: "1/3/2007 11:00".

Server

Facoltativo

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

Per specificare un altro server Trasporto Hub su cui eseguire il cmdlet Add-IPAllowListEntry, includere nel comando il parametro Server. Se non si utilizza il parametro Server, l'esecuzione del comando avviene sul server locale su cui viene eseguito il comando.

Non è possibile utilizzare questo cmdlet per configurare da remoto altri server Trasporto Edge.

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 illustra un comando Add-IPAllowListEntry che aggiunge un intervallo di indirizzi IP nell'elenco di indirizzi IP consentiti relativo al computer in cui è eseguito tale comando. Il secondo esempio di codice imposta la scadenza della stessa voce dell'elenco di indirizzi IP consentiti per le 23.59 del 3 gennaio 2007.

Add-IPAllowListEntry -IPRange:192.168.0.1/24 
Add-IPAllowListEntry -IPRange:192.168.0.1/24 -ExpirationTime "1/3/2007 23:59"