Partager via


Test-UMConnectivity

 

S’applique à : Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Dernière rubrique modifiée : 2008-01-30

La cmdlet Test-UMConnectivity permet de tester le fonctionnement d'un ordinateur sur lequel le rôle serveur de messagerie unifiée est installé.

Syntaxe

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>]]

Description détaillée

Les deux tests de diagnostic sont destinés à tester le fonctionnement du logiciel de serveur de messagerie unifiée Microsoft Exchange Server 2007 (mode 1), ainsi que le fonctionnement de l'ensemble du système qui inclut les composants téléphoniques connectés (mode 2).

La cmdlet Test-UMConnectivity permet de tester le fonctionnement d'un serveur de messagerie unifiée (MU) et de l'équipement téléphonique connecté. Quand un administrateur exécute cette cmdlet avec le paramètre UMIPGateway, le serveur de messagerie unifiée teste le fonctionnement complet de bout en bout du système de messagerie unifiée. Cela inclut les composants téléphoniques connectés au serveur de messagerie unifiée, tels que les passerelles IP, les PBX (Private Branch eXchanges) et le câblage. Si le paramètre IPGateway n'est pas spécifié, le serveur de messagerie unifiée teste uniquement le fonctionnement des composants de messagerie unifiée installés et configurés sur le serveur.

Pour exécuter la cmdlet Test-UMConnectivity, vous devez utiliser un compte auquel ont été délégués le rôle Administrateur de serveur Exchange et le groupe Administrateurs local pour le serveur cible.

Pour plus d'informations sur les autorisations, la délégation de rôles et les droits requis pour administrer Exchange 2007, consultez la rubrique Considérations relatives aux autorisations.

Paramètres

Paramètre Obligatoire Type Description

Phone

Obligatoire

System.String

Ce paramètre spécifie le numéro de téléphone ou l'URI SIP utilisé en cas de redirection de l'appel test. Le numéro de poste doit être configuré dans le PBX pour transférer l'appel au groupement de postes de MU.

PIN

Obligatoire

System.String

Ce paramètre spécifie le code confidentiel associé à la boîte aux lettres.

ResetPIN

Obligatoire

System.Boolean

Ce paramètre spécifie s'il faut générer ou re-générer un code confidentiel pour toutes les boîtes aux lettres de test dans le site actuel.

TUILogon

Obligatoire

System.Boolean

Ce paramètre spécifie si vous voulez que la cmdlet tente de se connecter à une ou plusieurs boîtes aux lettres à extension messagerie unifiée. Les boîtes aux lettres doivent être à extension messagerie unifiée et associées au plan de numérotation de messagerie unifiée auquel appartient le serveur de messagerie unifiée. Le paramètre par défaut est false.

TUILogonAll

Obligatoire

System.Boolean

Ce paramètre spécifie s'il faut tester toutes les boîtes aux lettres se trouvant dans le site Active Directory actuel, puis tester la connectivité avec chaque boîte aux lettres à extension messagerie unifiée. Le paramètre par défaut est false.

UMDialPlan

Obligatoire

Microsoft.Exchange.Configuration.Tasks.UMDialPlanIdParameter

Ce paramètre spécifie si le plan de numérotation de messagerie unifiée doit être testé. Il doit être utilisé avec le paramètre TUILogin.

UMIPGateway

Obligatoire

Microsoft.Exchange.Configuration.Tasks.UMIPGatewayIdParameter

Ce paramètre spécifie le nom de la passerelle IP de messagerie unifiée ou du PBX IP à utiliser pour l'appel test sortant.

Confirm

Facultatif

System.Management.Automation.SwitchParameter

Ce paramètre suspend le traitement par la commande et vous demande de confirmer les actions que la commande va effectuer avant de continuer le traitement. La valeur par défaut est $true.

DiagDtmfDurationInMilisecs

Facultatif

System.Int32

Ce paramètre spécifie la durée de chaque chiffre envoyé.

DiagDtmfSequence

Facultatif

System.String

Ce paramètre spécifie la séquence des chiffres envoyés.

DiagInitialSilenceInMilisecs

Facultatif

System.Int32

Ce paramètre spécifie le temps (exprimé en millisecondes) pendant lequel la cmdlet marque une pause avant l'envoi de la séquence de chiffres.

DiagInterDtmfDiffGapInMilisecs

Facultatif

System.String

Ce paramètre permet de personnaliser l'intervalle de temps entre les chiffres de la séquence de diagnostic. Il s'agit d'une liste délimitée par des virgules qui peut accepter des entrées de valeur null. Elle doit inclure plusieurs valeurs.

DiagInterDtmfGapInMilisecs

Facultatif

System.Int32

Ce paramètre spécifie l'intervalle de temps, en millisecondes, entre chaque chiffre envoyé dans la séquence de chiffres. Il s'agit d'une valeur unique.

DomainController

Facultatif

Microsoft.Exchange.Data.Fqdn

Ce paramètre spécifie le nom de domaine complet du contrôleur de domaine qui écrit ce changement de configuration dans le service d'annuaire Active Directory.

Fax

Facultatif

System.Boolean

Ce paramètre spécifie que l'appel testé est un appel de télécopie. Le paramètre par défaut est $true.

From

Facultatif

System.String

Ce paramètre spécifie l'URI SIP ou l'adresse SIP dont provient l'appel. Il est utilisé uniquement lorsque vous utilisez le paramètre -Phone. Le paramètre par défaut correspond à l'URI SIP spécifié lorsque vous utilisez le paramètre -Phone.

ListenPort

Facultatif

System.Int32

Ce paramètre spécifie le numéro de port IP à écouter. S'il n'est pas spécifié, le port IP 9000 est utilisé.

MediaSecured

Facultatif

System.Boolean

Ce paramètre spécifie s'il faut utiliser Secure RTP ou un mode non sécurisé.

MonitoringContext

Facultatif

System.Boolean

Ce paramètre spécifie si la cmdlet s'exécute dans une ligne de commande ou si l'objet sortie est transmis à Microsoft Operations Manager. Par défaut, la cmdlet s'exécute depuis la ligne de commande.

RemotePort

Facultatif

System.Int32

Ce paramètre spécifie le port à utiliser pour l'appel. Si la valeur n'est pas spécifiée, la valeur par défaut est le port 5060 pour TCP et 5061 pour MTLS.

Secured

Facultatif

System.Boolean

Ce paramètre spécifie si le test sera exécuté en mode sécurisé.

Timeout

Facultatif

System.Int32

Ce paramètre spécifie le temps d'attente (en secondes) pour l'achèvement de l'opération de test. La valeur par défaut est 180 secondes. Vous pouvez définir ce paramètre avec une valeur inférieure à 5 secondes. Il est toutefois recommandé de toujours configurer ce paramètre avec une valeur minimale de 5 secondes.

WhatIf

Facultatif

System.Management.Automation.SwitchParameter

Ce paramètre donne pour instruction à la commande de simuler les actions qu'elle va appliquer à l'objet. Grâce au paramètre WhatIf, vous pouvez afficher des changements potentiels sans devoir les appliquer. La valeur par défaut est $true.

Types d'entrées

Types de retours

Erreurs

Erreur Description

 

 

Exceptions

Exceptions Description

 

 

Exemple

Le premier exemple exécute des tests de connectivité et de fonctionnement sur le serveur de messagerie unifiée local, puis affiche les informations de connectivité VoIP (Voice over IP).

Le deuxième exemple test la capacité du serveur de messagerie unifiée local à utiliser une connexion TCP (Transmission Control Protocol) non sécurisée au lieu d'une connexion MTLS (Mutual Transport Layer Security) sécurisée pour établir un appel via une passerelle IP de messagerie unifiée nommée MyUMIPGateway à l'aide du numéro de téléphone 56780.

Le troisième exemple teste le numéro d'accès abonné dans un plan de numérotation à l'aide d'un URI SIP. Cet exemple peut être utilisé dans un environnement qui inclut Microsoft Office Communications Server 2007.

Le quatrième exemple teste un standard automatique à l'aide d'un URI SIP. Il est utilisé dans un environment incluant 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"