Set-UMIPGateway

Articolo
08/07/2014

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

Ultima modifica dell'argomento: 2007-07-17

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>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Name <String>] [-OutcallsAllowed <$true | $false>] [-Port <Int32>] [-Simulator <$true | $false>] [-Status <Enabled | Disabled | NoNewCalls>] [-WhatIf [<SwitchParameter>]]

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

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 (Session Initiation Protocol) 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 IP/PBX abilitato al SIP (Session Initiation Protocol) o il gateway IP. 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 delega del 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. Questo parametro è l'ID 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 in un IP/PBX (Private Branch eXchange) abilitato al SIP.
Confirm	Facoltativo	System.Management.Automation.SwitchParameter	Questo parametro consente di determinare la sospensione dell'elaborazione e di richiedere che l'amministratore confermi l'operazione che verrà eseguita dal comando prima che l'elaborazione continui. Il valore predefinito è $true.
DomainController	Facoltativo	Microsoft.Exchange.Data.Fqdn	Questo parametro consente di 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.
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.
WhatIf	Facoltativo	System.Management.Automation.SwitchParameter	Questo parametro consente di indicare al comando di simulare le azioni da eseguire sull'oggetto. Utilizzando il parametro WhatIf, l'amministratore può visualizzare quali sono le modifiche che verrebbero apportate senza applicarle. Il valore predefinito è $true.

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 del gateway IP e può essere utilizzato con il cmdlet Test-UMConnectivity o con l'applicazione Exchange UM Test Phone.

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

Condividi tramite