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