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.1Con 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 $falseCon 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 $falseIn 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 $trueCon 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.