Test-UMConnectivity (RTM)
S’applique à : Exchange Server 2007
Dernière rubrique modifiée : 2007-10-02
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 [-DomainController <Fqdn>] [-Fax <$true | $false>] [-ListenPort <Int32>] [-MonitoringContext <$true | $false>] [-Secured <$true | $false>] [-Timeout <Int32>]
test-UMConnectivity -ResetPIN <$true | $false> [-DomainController <Fqdn>] [-MonitoringContext <$true | $false>]
test-UMConnectivity -Phone <String> -UMIPGateway <UMIPGatewayIdParameter> [-DomainController <Fqdn>] [-Fax <$true | $false>] [-ListenPort <Int32>] [-MonitoringContext <$true | $false>] [-Secured <$true | $false>] [-Timeout <Int32>]
test-UMConnectivity -TUILogonAll <$true | $false> [-DomainController <Fqdn>] [-ListenPort <Int32>] [-MonitoringContext <$true | $false>] [-Secured <$true | $false>] [-Timeout <Int32>]
test-UMConnectivity -Phone <String> -PIN <String> -TUILogon <$true | $false> -UMDialPlan <UMDialPlanIdParameter> [-DomainController <Fqdn>] [-ListenPort <Int32>] [-MonitoringContext <$true | $false>] [-Secured <$true | $false>] [-Timeout <Int32>]
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 IPGateway, 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 Server 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 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. |
code confidentiel |
Obligatoire |
System.String |
Ce paramètre spécifie le code confidentiel associé à la boîte aux lettres. |
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 commutation des appels 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. |
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. |
UMDialPlan |
Obligatoire |
Microsoft.Exchange.Configuration.Tasks.UMDialPlanIdParameter |
Ce paramètre spécifie si le plan de commutation des appels de messagerie unifiée doit être testé. Il doit être utilisé avec le paramètre TUILogin. |
DomainController |
Facultatif |
Microsoft.Exchange.Data.Fqdn |
Le paramètre DomainController spécifie le contrôleur de domaine à utiliser pour écrire cette modification de configuration dans Active Directory. Utilisez le nom de domaine complet (FQDN) du contrôleur de domaine que vous voulez utiliser. |
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 |
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é. |
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. |
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. |
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. |
DomainController |
Facultatif |
Microsoft.Exchange.Data.Fqdn |
Le paramètre DomainController spécifie le contrôleur de domaine à utiliser pour écrire cette modification de configuration dans Active Directory. Utilisez le nom de domaine complet (FQDN) du contrôleur de domaine que vous voulez utiliser. |
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.
Test-UMConnectivity
Test-UMConnectivity -UMIPGateway MyUMIPGateway -Phone 56780 -Secured $false