Set-UMIPGateway

Questo cmdlet è disponibile solo in Exchange locale.

Utilizzare il cmdlet Set-UMIPGateway 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 gateway IP di messaggistica unificata specificato.

Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.

Sintassi

Set-UMIPGateway
   [-Identity] <UMIPGatewayIdParameter>
   [-Address <UMSmartHost>]
   [-Confirm]
   [-DelayedSourcePartyInfoEnabled <Boolean>]
   [-DomainController <Fqdn>]
   [-ForceUpgrade]
   [-IPAddressFamily <IPAddressFamily>]
   [-MessageWaitingIndicatorAllowed <Boolean>]
   [-Name <String>]
   [-OutcallsAllowed <Boolean>]
   [-Port <Int32>]
   [-Simulator <Boolean>]
   [-Status <GatewayStatus>]
   [-WhatIf]
   [<CommonParameters>]

Descrizione

Il cmdlet Set-UMIPGateway modifica le impostazioni di configurazione per uno specifico 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 (Private Branch eXchange) abilitato al SIP (Session Initiation Protocol) o un gateway IP.

È possibile che le modifiche alle impostazioni del gateway IP di messaggistica unificata determinino l'interruzione delle comunicazioni tra i server Cassette postali e il gateway IP PBX abilitato al SIP (Session Initiation Protocol) o il gateway IP. Le modifiche a un 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.

Una volta completata questa attività, i parametri e i valori specificati vengono configurati sul gateway IP di messaggistica unificata.

È necessario disporre delle autorizzazioni prima di poter eseguire questo cmdlet. Sebbene in questo argomento vengano elencati tutti i parametri relativi al cmdlet, si potrebbe non avere accesso ad alcuni di essi qualora non siano inclusi nelle autorizzazioni assegnate. Per individuare le autorizzazioni necessarie per eseguire cmdlet o parametri nell'organizzazione, vedere Trovare le autorizzazioni necessarie per eseguire i cmdlet di Exchange.

Esempio

Esempio 1

Set-UMIPGateway -Identity MyUMIPGateway -Address 10.10.10.1

Con questo esempio viene modificato l'indirizzo IP del gateway IP di messaggistica unificata MyUMIPGateway.

Esempio 2

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

Con questo esempio viene impedito al gateway IP di messaggistica unificata di accettare le chiamate in arrivo e non vengono consentite le chiamate in uscita.

Esempio 3

Set-UMIPGateway -Identity MyUMIPGateway -Address fe80::39bd:88f7:6969:d223%11 -IPAddressFamily Any -Status Disabled -OutcallsAllowed $false

In questo esempio, viene impedito al gateway IP di messaggistica unificata MyUMIPGateway di accettare chiamate in arrivo e chiamate in uscita, viene impostato un indirizzo IPv6 e viene consentito al gateway IP di messaggistica unificata di utilizzare sia indirizzi IPv4 che indirizzi IPv6.

Esempio 4

Set-UMIPGateway -Identity MyUMIPGateway -Simulator $true

Con questo 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.

Parametri

-Address

Il parametro Address consente di specificare l'indirizzo IP o il nome di dominio completo (FQDN) configurato nel gateway IP di messaggistica unificata o in un IP PBX abilitato al SIP. Se il dial plan di messaggistica unificata associato al gateway IP di messaggistica unificata opera nella modalità SIP protetta o Protetta, è necessario un nome di dominio completo. Se viene utilizzato un nome di dominio completo, è necessario verificare che il DNS (Domain Name System) sia stato configurato correttamente.

Type:UMSmartHost
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016

-Confirm

L'opzione Confirm consente di specificare se visualizzare o nascondere la richiesta di conferma. L'impatto di questa opzione sul cmdlet dipende dalla richiesta di conferma del cmdlet prima di procedere.

  • I cmdlet distruttivi , ad esempio i cmdlet Remove-*, hanno una pausa predefinita che impone di confermare il comando prima di procedere. Per questi cmdlet, è possibile ignorare la richiesta di conferma usando questa precisa sintassi: -Confirm:$false.
  • La maggior parte degli altri cmdlet (ad esempio, i cmdlet New-* e Set-*) non hanno una pausa predefinita. Per questi cmdlet, specificando l'opzione Confirm senza un valore viene introdotta una pausa che impone all'utente di confermare il comando prima di procedere.
Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016

-DelayedSourcePartyInfoEnabled

Il parametro DelayedSourcePartyInfoEnabled consente di specificare se la Messaggistica unificata deve ritardare il processo di accettazione di una chiamata in ingresso dal gateway VoIP (Voice over IP) se il corrispondente SIP INVITE della chiamata non contiene informazioni sulla parte chiamante e sulla deviazione.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016

-DomainController

Il parametro DomainController consente di specificare il controller di dominio utilizzato da questo cmdlet per la lettura o la scrittura dei dati in Active Directory. Identificare il controller di dominio mediante il relativo nome di dominio completo (FQDN). Ad esempio, dc01.contoso.com.

Type:Fqdn
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016

-ForceUpgrade

L'opzione ForceUpgrade elimina il messaggio di conferma visualizzato se l'oggetto è stato creato in una versione precedente di Exchange. Con questa opzione non è necessario specificare alcun valore.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016

-Identity

Il parametro Identity 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.

Type:UMIPGatewayIdParameter
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016

-IPAddressFamily

Il parametro IPAddressFamily consente di specificare se il gateway IP di messaggistica unificata utilizzerà l'IP versione 4 (IPv4), IPv6 o entrambi per comunicare. I valori validi sono:

  • IPv4Only: il gateway IP di messaggistica unificata userà solo IPv4 per comunicare. Questo è il valore predefinito.
  • IPv6Only: il gateway IP di messaggistica unificata userà solo IPv6.
  • Qualsiasi: IPv6 verrà usato per primo e quindi, se necessario, tornerà a IPv4.
Type:IPAddressFamily
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016

-MessageWaitingIndicatorAllowed

Il parametro MessageWaitingIndicatorAllowed consente di specificare se abilitare il gateway IP di messaggistica unificata per consentire l'invio di messaggi SIP NOTIFY agli utenti associati a un dial plan di messaggistica unificata e al gateway IP di messaggistica unificata. Il valore predefinito è $true.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016

-Name

Il parametro Name consente di specificare il nome visualizzato per il gateway IP di messaggistica unificata. Il nome visualizzato può avere una lunghezza massima di 64 caratteri.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016

-OutcallsAllowed

Il parametro OutcallsAllowed consente di specificare se consentire l'utilizzo di questo gateway IP di messaggistica unificata per le chiamate in uscita. Il parametro non regola il trasferimento delle chiamate.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016

-Port

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

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016

-Simulator

Il parametro Simulator consente di specificare il simulatore utilizzato per il gateway IP di messaggistica unificata visualizzato. Il simulatore consente a un client di connettersi al server Cassette postali.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016

-Status

Il parametro Status consente di specificare se abilitare o disabilitare il gateway IP di messaggistica unificata. I valori validi sono:

  • Abilitato
  • Disattivato
  • NoNewCalls
Type:GatewayStatus
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016

-WhatIf

L'opzione WhatIf consente di simulare le azioni del comando. È possibile utilizzare tale opzione per visualizzare le modifiche che verrebbero applicate senza effettivamente applicarle. Con questa opzione non è necessario specificare alcun valore.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016

Input

Input types

Per verificare i tipi di input accettati da questo cmdlet, vedere Tipi di input e output dei cmdlet. Se il campo relativo al tipo di input di un cmdlet è vuoto, il cmdlet non accetta dati di input.

Output

Output types

Per verificare i tipi restituiti, detti anche tipi di output, accettati da questo cmdlet, vedere Tipi di input e output dei cmdlet. Se il campo relativo al tipo di output è vuoto, il cmdlet non restituisce dati.