Condividi tramite


Set-UMIPGateway (RTM)

 

Si applica a: Exchange Server 2007

Ultima modifica dell'argomento: 2007-07-12

Il cmdlet Set-UMIPGateway viene utilizzato per modificare le impostazioni di configurazione per un singolo gateway IP di messaggistica unificata o per restituire un elenco di impostazioni di configurazione che è possibile modificare in un determinato gateway IP di messaggistica unificata.

Sintassi

Set-UMIPGateway -Identity <UMIPGatewayIdParameter> [-Address <UMSmartHost>] [-DomainController <Fqdn>] [-Name <String>] [-OutcallsAllowed <$true | $false>] [-Port <Int32>] [-Simulator <$true | $false>] [-Status <Enabled | Disabled | NoNewCalls>]

Set-UMIPGateway [-Address <UMSmartHost>] [-DomainController <Fqdn>] [-Instance <UMIPGateway>] [-Name <String>] [-OutcallsAllowed <$true | $false>] [-Port <Int32>] [-Simulator <$true | $false>] [-Status <Enabled | Disabled | NoNewCalls>]

Descrizione dettagliata

Il cmdlet Set-UMIPGateway modifica le impostazioni di configurazione per un gateway IP di messaggistica unificata, ad esempio l'indirizzo IP del gateway IP. Tali modifiche includono l'autorizzazione delle chiamate in uscita e il controllo delle comunicazioni con un gateway IP-PBX abilitato al SIP o un gateway IP.

Importante

È possibile che le modifiche alle impostazioni del gateway IP di messaggistica unificata determinino l'interruzione delle comunicazioni tra i server Messaggistica unificata e il gateway abilitato al SIP o il gateway IP IP-PBX. Le modifiche a un oggetto gateway IP di messaggistica unificata devono essere eseguite esclusivamente da un amministratore che comprende perfettamente le implicazioni delle modifiche alla configurazione del gateway IP di messaggistica unificata.

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

  • Ruolo Exchange Organization Administrator

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.UMIPGatewayIdParameter

Questo parametro consente di specificare l'identificatore del gateway IP di messaggistica unificata che si desidera modificare. Rappresenta inoltre l'ID dell'oggetto directory del gateway IP di messaggistica unificata.

Address

Facoltativo

Microsoft.Exchange.Data.UMSmartHost

Questo parametro consente di specificare l'indirizzo IP configurato nel gateway IP o un IP-PBX abilitato al SIP (Session Initiation Protocol).

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 cmdlet il parametro DomainController.

Instance

Facoltativo

Microsoft.Exchange.Data.Directory.SystemConfiguration.UMIPGateway

Questo parametro consente di specificare il parametro di input che rappresenta un nuovo gateway IP.

Name

Facoltativo

System.String

Questo parametro consente di specificare il nome visualizzato che verrà utilizzato per il gateway IP di messaggistica unificata. Il nome visualizzato può avere una lunghezza massima di 64 caratteri.

OutcallsAllowed

Facoltativo

System.Boolean

Questo parametro consente di specificare se consentire l'utilizzo dell'oggetto gateway IP per le chiamate in uscita. Il parametro non regola il trasferimento delle chiamate.

Port

Facoltativo

System.Int32

Questo parametro consente di specificare la porta IP su cui il gateway IP o IP-PBX è in ascolto. Per impostazione predefinita, si tratta della porta 5060. L'intervallo per questo parametro è compreso fra 0 e 65535.

Simulator

Facoltativo

System.Boolean

Questo parametro consente di specificare il simulatore che verrà utilizzato per il gateway IP di messaggistica unificata che si desidera visualizzare. Il simulatore consente a un client di connettersi al server Messaggistica unificata. Questa connessione viene in genere utilizzata nell'applicazione Exchange Test Phone.

Status

Facoltativo

Microsoft.Exchange.Data.Directory.SystemConfiguration.GatewayStatus

Questo parametro consente di specificare se abilitare o disabilitare il gateway IP di messaggistica unificata.

Tipi di input

Tipi restituiti

Errori

Errore Descrizione

 

 

Eccezioni

Eccezioni Descrizione

 

 

Esempio

Nel primo codice di esempio viene modificato l'indirizzo IP di un gateway IP di messaggistica unificata denominato MyUMIPGateway.

Nel secondo codice di esempio non viene consentito al gateway IP di messaggistica unificata di accettare chiamate in arrivo e non vengono consentite chiamate in uscita.

Nel terzo esempio il gateway IP di messaggistica unificata viene abilitato alla funzione di simulatore IP/VoIP.

Set-UMIPGateway -Identity MyUMIPGateway -Address 10.10.10.1

Set-UMIPGateway -Identity MyUMIPGateway -Address 10.10.10.1 -Status 2 -OutcallsAllowed $false

Set-UMIPGateway -Identity MyUMIPGateway -Simulator $true