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 è |
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"