Condividi tramite


Test-UMConnectivity

Questo cmdlet è disponibile solo in Exchange locale.

Usare il cmdlet Test-UMConnectivity per testare il funzionamento dei server messaggistica unificata.

Nota: questo cmdlet funziona meglio in Exchange 2010. Nelle versioni successive di Exchange, la funzionalità di questo cmdlet è stata sostituita da Disponibilità gestita. Per ottenere risultati ottimali, usare il cmdlet Invoke-MonitoringProbe e specificare il probe di monitoraggio attivo pertinente anziché usare questo cmdlet.

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

Sintassi

Test-UMConnectivity
    -Phone <String>
    -PIN <String>
    -TUILogon <Boolean>
    -UMDialPlan <UMDialPlanIdParameter>
    [-CertificateThumbprint <String>]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-ListenPort <Int32>]
    [-MediaSecured <Boolean>]
    [-MonitoringContext <Boolean>]
    [-RemotePort <Int32>]
    [-Secured <Boolean>]
    [-Timeout <Int32>]
    [-WhatIf]
    [<CommonParameters>]
Test-UMConnectivity
    -Phone <String>
    -UMIPGateway <UMIPGatewayIdParameter>
    [-DiagDtmfDurationInMilisecs <Int32>]
    [-DiagDtmfSequence <String>]
    [-DiagInitialSilenceInMilisecs <Int32>]
    [-DiagInterDtmfDiffGapInMilisecs <String>]
    [-DiagInterDtmfGapInMilisecs <Int32>]
    [-From <String>]
    [-CertificateThumbprint <String>]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-ListenPort <Int32>]
    [-MediaSecured <Boolean>]
    [-MonitoringContext <Boolean>]
    [-Secured <Boolean>]
    [-Timeout <Int32>]
    [-WhatIf]
    [<CommonParameters>]
Test-UMConnectivity
    -ResetPIN <Boolean>
    [-Confirm]
    [-DomainController <Fqdn>]
    [-MonitoringContext <Boolean>]
    [-WhatIf]
    [<CommonParameters>]
Test-UMConnectivity
    -TUILogonAll <Boolean>
    [-CertificateThumbprint <String>]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-ListenPort <Int32>]
    [-MediaSecured <Boolean>]
    [-MonitoringContext <Boolean>]
    [-RemotePort <Int32>]
    [-Secured <Boolean>]
    [-Timeout <Int32>]
    [-WhatIf]
    [<CommonParameters>]
Test-UMConnectivity
    [-CallRouter]
    [-CertificateThumbprint <String>]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-ListenPort <Int32>]
    [-MediaSecured <Boolean>]
    [-MonitoringContext <Boolean>]
    [-RemotePort <Int32>]
    [-Secured <Boolean>]
    [-Timeout <Int32>]
    [-WhatIf]
    [<CommonParameters>]

Descrizione

Due test diagnostici sono progettati per testare il funzionamento del software del server Cassette postali (modalità 1) e il funzionamento dell'intero sistema che include i componenti di telefonia connessi (modalità 2).

Il cmdlet Test-UMConnectivity può essere usato per testare il funzionamento di un server Cassette postali e delle apparecchiature di telefonia connesse correlate. Quando si esegue questo cmdlet e si include il parametro UMIPGateway, il server Cassette postali testa l'intera operazione end-to-end del sistema di messaggistica unificata. Questo test include i componenti di telefonia connessi al server Cassette postali, ad esempio gateway IP, eXchanges di Private Branch (PBX) e cablaggio. Se il parametro UMIPGateway non è specificato, il server Cassette postali testa solo il funzionamento dei componenti di messaggistica unificata installati e configurati nel server.

Quando si esegue questo cmdlet in una distribuzione di messaggistica unificata locale, è necessario creare un oggetto gateway IP di messaggistica unificata per il computer o il server testato dal cmdlet. Quando si crea l'oggetto gateway IP di messaggistica unificata, è necessario configurarlo con un nome di dominio completo (FQDN) e tale FQDN deve corrispondere al nome del computer che esegue questo cmdlet.

Al termine di questa attività, il cmdlet avrà testato il funzionamento del server Cassette postali e dei componenti di telefonia correlati.

È 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

Test-UMConnectivity

Con questo esempio vengono eseguiti test operativi e di connettività sul server Cassette postali locale e vengono visualizzate le informazioni sulla connettività Voice over IP (VoIP).

Esempio 2

Test-UMConnectivity -UMIPGateway MyUMIPGateway -Phone 56780 -Secured $false

In questo esempio viene verificata la capacità del server Cassette postali locale di usare una connessione TCP non protetta anziché una connessione TLS reciproca protetta per effettuare una chiamata tramite il gateway IP di messaggistica unificata MyUMIPGateway usando il numero di telefono 56780.

Esempio 3

Test-UMConnectivity -Phone sip:sipdp.contoso.com@contoso.com -UMIPGateway MyUMIPGateway -Secured $true -From sip:user1@contoso.com -MediaSecured $true

In questo esempio viene testato un dial plan SIP usando un URI SIP. Questo esempio può essere usato in un ambiente che include Lync Server o Skype for Business Server.

Parametri

-CallRouter

L'opzione CallRouter specifica se testare il servizio Microsoft Exchange Unified Messaging Call Router (front-end). 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 2013, Exchange Server 2016

-CertificateThumbprint

Il parametro CertificateThumbprint consente di specificare l'identificazione personale del certificato utilizzata per la modalità SIP protetta e protetta.

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

-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

-DiagDtmfDurationInMilisecs

Il parametro DiagDtmfDurationInMilisecs specifica la durata di ogni cifra inviata.

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

-DiagDtmfSequence

Il parametro DiagDtmfSequence specifica la sequenza di cifre inviate.

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

-DiagInitialSilenceInMilisecs

Il parametro DiagInitialSilenceInMilisecs specifica il periodo di tempo in millisecondi in cui il cmdlet viene sospeso prima dell'invio della sequenza di cifre.

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

-DiagInterDtmfDiffGapInMilisecs

Il parametro DiagInterDtmfDiffGapInMilisecs specifica se personalizzare l'ora tra le cifre nella sequenza di diagnostica. Si tratta di un elenco delimitato da virgole che può accettare voci Null. Devono essere inclusi più valori.

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

-DiagInterDtmfGapInMilisecs

Il parametro DiagInterDtmfGapInMilisecs specifica il tempo in millisecondi tra ogni cifra inviata nella sequenza di cifre. Si tratta di un singolo valore.

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

-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

-From

Il parametro From specifica l'URI SIP o l'indirizzo SIP da cui ha origine la chiamata. Viene usato solo quando si usa il parametro Phone. L'impostazione predefinita è l'URI SIP specificato quando si usa il parametro Phone.

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

-ListenPort

Il parametro ListenPort specifica il numero di porta IP su cui restare in ascolto. Se non specificato, viene usata la porta IP 9000.

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

-MediaSecured

Il parametro MediaSecured specifica se utilizzare la modalità RTP sicura o RTP (non protetta).

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

-MonitoringContext

Il parametro MonitoringContext consente di specificare se includere gli eventi di monitoraggio e i contatori delle prestazioni associati nei risultati. I valori validi sono:

  • $true: i risultati del comando includono eventi di monitoraggio e contatori delle prestazioni. In genere, si includono gli eventi di monitoraggio e i contatori delle prestazioni nei risultati quando l'output viene passato a Microsoft System Center Operations Manager (SCOM).
  • $false: gli eventi di monitoraggio e i contatori delle prestazioni non sono inclusi nei risultati del comando. Questo è il valore predefinito.
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

-Phone

Il parametro Phone consente di specificare il numero di telefono o l'URI (Uniform Resource Identifier) SIP (Session Initiation Protocol) usato quando viene reindirizzata la chiamata di test. Il numero di estensione deve essere configurato nel PBX per inoltrare le chiamate al gruppo di risposta di messaggistica unificata.

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

-PIN

Il parametro PIN specifica il PIN associato alla cassetta postale abilitata per la messaggistica unificata.

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

-RemotePort

Il parametro RemotePort consente di specificare la porta utilizzata per la chiamata. Se non specificato, il valore predefinito è la porta 5060 per TCP (Transmission Control Protocol) e 5061 per la sicurezza reciproca del livello di trasporto (TLS).

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

-ResetPIN

Il parametro ResetPIN specifica se generare o rigenerare un nuovo PIN per tutte le cassette postali di test nel sito corrente.

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

-Secured

Il parametro Secured consente di specificare se il test viene eseguito in modalità protetta SIP.

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

-Timeout

Il parametro Timeout consente di specificare l'intervallo di tempo in secondi di attesa del completamento dell'operazione di test. Il valore predefinito è 600 secondi. Non è possibile impostare questo parametro con un valore inferiore a 60 secondi. Tuttavia, è consigliabile configurare sempre questo parametro con un valore pari o superiore a 60 secondi. Il valore massimo per questo parametro è 1800 secondi.

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

-TUILogon

Il parametro TUILogon specifica se il cmdlet tenta di accedere a una o più cassette postali abilitate per la messaggistica unificata. Le cassette postali devono essere abilitate per la messaggistica unificata e associate al dial plan di messaggistica unificata a cui appartiene il server Cassette postali che esegue il servizio Messaggistica unificata di Microsoft Exchange. L'impostazione predefinita è $false.

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

-TUILogonAll

Il parametro TUILogonAll consente di specificare se provare a connettersi a tutte le cassette postali di test nel sito di Active Directory corrente. L'impostazione predefinita è $false. Gli account testati devono essere generati chiamando lo script New-TestCasConnectivityUser.ps1 e le cassette postali corrispondenti devono essere abilitate per la messaggistica unificata. In caso contrario, non viene eseguita alcuna azione.

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

-UMDialPlan

Il parametro UMDialPlan specifica il dial plan di messaggistica unificata da testare. Questo parametro deve essere usato con il parametro TUILogon.

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

-UMIPGateway

Il parametro UMIPGateway specifica il nome del gateway IP di messaggistica unificata o IP PBX da usare per la chiamata di test in uscita.

Type:UMIPGatewayIdParameter
Position:Named
Default value:None
Required:True
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.