Share via


Test-UMConnectivity

 

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

Ultima modifica dell'argomento: 2008-01-30

Il cmdlet Test-UMConnectivity può essere utilizzato per verificare il funzionamento di un computer in cui è installato il ruolo del server Messaggistica unificata.

Sintassi

test-UMConnectivity [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Fax <$true | $false>] [-ListenPort <Int32>] [-MediaSecured <$true | $false>] [-MonitoringContext <$true | $false>] [-RemotePort <Int32>] [-Secured <$true | $false>] [-Timeout <Int32>] [-WhatIf [<SwitchParameter>]]

test-UMConnectivity -TUILogonAll <$true | $false> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-ListenPort <Int32>] [-MediaSecured <$true | $false>] [-MonitoringContext <$true | $false>] [-RemotePort <Int32>] [-Secured <$true | $false>] [-Timeout <Int32>] [-WhatIf [<SwitchParameter>]]

test-UMConnectivity -ResetPIN <$true | $false> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-MonitoringContext <$true | $false>] [-WhatIf [<SwitchParameter>]]

test-UMConnectivity -Phone <String> -UMIPGateway <UMIPGatewayIdParameter> [-Confirm [<SwitchParameter>]] [-DiagDtmfDurationInMilisecs <Int32>] [-DiagDtmfSequence <String>] [-DiagInitialSilenceInMilisecs <Int32>] [-DiagInterDtmfDiffGapInMilisecs <String>] [-DiagInterDtmfGapInMilisecs <Int32>] [-DomainController <Fqdn>] [-Fax <$true | $false>] [-From <String>] [-ListenPort <Int32>] [-MediaSecured <$true | $false>] [-MonitoringContext <$true | $false>] [-Secured <$true | $false>] [-Timeout <Int32>] [-WhatIf [<SwitchParameter>]]

test-UMConnectivity -Phone <String> -PIN <String> -TUILogon <$true | $false> -UMDialPlan <UMDialPlanIdParameter> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-ListenPort <Int32>] [-MediaSecured <$true | $false>] [-MonitoringContext <$true | $false>] [-RemotePort <Int32>] [-Secured <$true | $false>] [-Timeout <Int32>] [-WhatIf [<SwitchParameter>]]

Descrizione dettagliata

I due test diagnostici sono stati progettati per verificare l'esecuzione del software del server Messaggistica unificata di Microsoft Exchange Server 2007 (modalità 1) e il funzionamento dell'intero sistema, inclusi i componenti telefonici collegati (modalità 2).

Il cmdlet Test-UMConnectivity può essere utilizzato per verificare il funzionamento di un server Messaggistica unificata e delle relative apparecchiature telefoniche connesse. Quando un amministratore esegue il cmdlet con il parametro UMIPGateway, il server Messaggistica unificata esegue il test dell'intera operatività end-to-end del sistema di messaggistica. Ciò comprende i componenti telefonici connessi al server Messaggistica unificata, quali i gateway IP, i sistemi Private Branch eXchange (PBX) e i cavi. Se il parametro IPGateway non viene specificato, il server Messaggistica unificata verificherà solo il funzionamento dei componenti di messaggistica unificata installati e configurati nel server.

Per eseguire il cmdlet Test-UMConnectivity, è necessario utilizzare un account che disponga della delega del ruolo di Exchange Server Administrator e del gruppo Administrators locale per il server di destinazione.

Per ulteriori informazioni sulle autorizzazioni, sulla delega dei ruoli e sui diritti necessari per l'amministrazione di Exchange 2007, vedere Considerazioni sulle autorizzazioni.

Parametri

Parametro Obbligatorio Tipo Descrizione

Phone

Obbligatorio

System.String

Questo parametro consente di specificare il numero di telefono o l'URI SIP che verrà utilizzato quando la chiamata di test viene reindirizzata. Il numero di interno deve essere configurato nel sistema PBX (Private Branch eXchange) per l'inoltro della chiamata al gruppo di risposta di messaggistica unificata.

PIN

Obbligatorio

System.String

Questo parametro consente di specificare che il PIN venga associato ad una cassetta postale abilitata alla messaggistica unificata.

ResetPIN

Obbligatorio

System.Boolean

Questo parametro consente di specificare se generare o rigenerare un nuovo PIN per tutte le cassette postali di test nel sito corrente.

TUILogon

Obbligatorio

System.Boolean

Questo parametro consente di specificare se il cmdlet debba tentare di accedere a una o più cassette postali abilitate alla messaggistica unificata. Le cassette postali devono essere abilitate alla messaggistica unificata e associate al dial plan a cui appartiene il server Messaggistica unificata. L'impostazione predefinita è false.

TUILogonAll

Obbligatorio

System.Boolean

Questo parametro consente di specificare se eseguire il test prima di tutte le cassette postali del sito Active Directory corrente e poi della connettività a ciascuna cassetta postale abilitata alla messaggistica unificata. L'impostazione predefinita è false.

UMDialPlan

Obbligatorio

Microsoft.Exchange.Configuration.Tasks.UMDialPlanIdParameter

Questo parametro consente di specificare il dial plan di messaggistica unificata di cui verrà eseguito il test. Deve essere utilizzato con il parametro TUILogin.

UMIPGateway

Obbligatorio

Microsoft.Exchange.Configuration.Tasks.UMIPGatewayIdParameter

Questo parametro consente di specificare il nome del gateway IP di messaggistica unificata o il sistema IP PBX da utilizzare per la chiamata di test in uscita.

Confirm

Facoltativo

System.Management.Automation.SwitchParameter

Questo parametro determina la sospensione dell'elaborazione e richiede che l'utente confermi l'operazione che verrà eseguita dal comando prima che l'elaborazione continui. Il valore predefinito è $true.

DiagDtmfDurationInMilisecs

Facoltativo

System.Int32

Questo parametro consente di specificare la durata di ogni cifra inviata.

DiagDtmfSequence

Facoltativo

System.String

Questo parametro consente di specificare la sequenza delle cifre inviate.

DiagInitialSilenceInMilisecs

Facoltativo

System.Int32

Questo parametro consente di specificare il periodo di tempo (millisecondi) di pausa del cmdlet prima dell'invio della sequenza di cifre.

DiagInterDtmfDiffGapInMilisecs

Facoltativo

System.String

Questo parametro viene utilizzato per personalizzare l'intervallo di tempo tra le cifre nella sequenza diagnostica. Si tratta di un elenco delimitato da virgole che può accettare voci vuote. Esso deve includere più valori.

DiagInterDtmfGapInMilisecs

Facoltativo

System.Int32

Questo parametro consente di specificare il periodo di tempo, in millisecondi, tra una cifra e l'altra della sequenza inviata. Si tratta di un valore singolo.

DomainController

Facoltativo

Microsoft.Exchange.Data.Fqdn

Questo parametro consente di specificare il nome di dominio completo (FQDN, fully qualified domain name) del controller di dominio che scrive questa modifica alla configurazione nel servizio directory di Active Directory.

Fax

Facoltativo

System.Boolean

Questo parametro consente di specificare che la chiamata sulla quale eseguire la verifica è una chiamata fax. L'impostazione predefinita è $true.

From

Facoltativo

System.String

Questo parametro consente di specificare l'URI SIP o l'indirizzo SIP da cui ha avuto origine la chiamata. Viene utilizzato solo se si utilizza il parametro -Phone. L'impostazione predefinita è l'URI SIP specificato quando si utilizza il parametro -Phone.

ListenPort

Facoltativo

System.Int32

Questo parametro consente di specificare il numero della porta IP di ascolto. Se non è altrimenti specificata, verrà utilizzata la porta 9000.

MediaSecured

Facoltativo

System.Boolean

Questo parametro consente di specificare l'utilizzo del protocollo RTP protetto o della modalità non protetta.

MonitoringContext

Facoltativo

System.Boolean

Questo parametro consente di specificare se il cmdlet verrà eseguito mediante la riga di comando o se l'oggetto output verrà passato a Microsoft Operations Manager. Per impostazione predefinita, il cmdlet verrà eseguito dalla riga di comando.

RemotePort

Facoltativo

System.Int32

Questo parametro consente di specificare la porta utilizzata per la chiamata. Se non specificato diversamente, la porta predefinita è la 5060 per TCL e la 5061 per MTLS.

Secured

Facoltativo

System.Boolean

Questo parametro consente di specificare se la verifica verrà eseguita in modalità protetta.

Timeout

Facoltativo

System.Int32

Questo parametro consente di specificare il tempo di attesa per il completamento dell'operazione di test (in secondi). L'impostazione predefinita è 180 secondi. È possibile impostare il parametro con un valore inferiore a 5 secondi, tuttavia, si consiglia di configurarlo sempre con un valore pari o superiore a 5 secondi.

WhatIf

Facoltativo

System.Management.Automation.SwitchParameter

Questo parametro consente di indicare al comando di simulare le azioni da eseguire sull'oggetto. Il parametro WhatIf consente di visualizzare le modifiche che verrebbero apportate senza applicarle. Il valore predefinito è $true.

Tipi di input

Tipi restituiti

Errori

Errore Descrizione

 

 

Eccezioni

Eccezioni Descrizione

 

 

Esempio

Il primo esempio consente di eseguire test operativi e di connettività sul server Messaggistica unificata locale e visualizzare le informazioni sulla connettività Voice over IP (VoIP).

Il secondo esempio permette di verificare la capacità del server Messaggistica unificata locale di utilizzare una connessione Transmission Control Protocol (TCP) non protetta al posto di una connessione Mutual Transport Layer Security (MTLS) protetta per una chiamata mediante un gateway IP di messaggistica unificata denominato MyUMIPGateway utilizzando il numero di telefono 56780.

Nel terzo esempio viene eseguito un test del numero di accesso sottoscrittore in un dial plan mediante un URI SIP. Questo esempio può essere applicato in un ambiente che include Microsoft Office Communications Server 2007.

Nel quarto esempio viene verificato un operatore automatico mediante un URI SIP. Si applica a un ambiente che contiene Communications Server 2007.

Test-UMConnectivity

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

Test-UMConnectivity -UMIPGateway OCSGateway1 -Phone "sip:SIPdialplan.contoso.com@contoso.com"

Test-UMConnectivity -UMIPGateway OCSGateway1 -Phone "sip:SIPAutoAttendant.SIPDialPlan.contoso.com@contoso.com"