New-UMIPGateway
S’applique à : Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Dernière rubrique modifiée : 2007-07-12
La cmdlet New-UMIPGateway crée une passerelle IP de messagerie unifiée (MU). Une passerelle IP de messagerie unifiée permet de connecter des serveurs de messagerie unifiée à une passerelle IP ou un PBX IP activé pour le protocle SIP (Session Initiation Protocol).
Syntaxe
New-UMIPGateway -Name <String> -Address <UMSmartHost> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-TemplateInstance <PSObject>] [-UMDialPlan <UMDialPlanIdParameter>] [-WhatIf [<SwitchParameter>]]
Description détaillée
La cmdlet New-UMIPGateway crée une passerelle IP de MU. Une passerelle IP de messagerie unifiée a une portée à l'échelle de l'organisation et fait référence à une passerelle IP physique unique. La nouvelle passerelle IP de MU créée est utilisée pour établir une connexion à une passerelle IP ou un PBX IP compatible SIP.
Pour exécuter la cmdlet New-UMIPGateway, vous devez utiliser un compte auquel a été délégué le rôle Administrateur d'organisation Exchange.
Pour plus d'informations sur les autorisations, la délégation de rôles et les droits requis pour administrer Microsoft Exchange Server 2007, consultez la rubrique Considérations relatives aux autorisations.
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
Address |
Obligatoire |
Microsoft.Exchange.Data.UMSmartHost |
Ce paramètre spécifie l'adresse IP configurée sur la passerelle IP ou le PBX IP compatible SIP. |
Name |
Obligatoire |
System.String |
Ce paramètre spécifie le nom complet pour la passerelle IP de MU. Le nom de la nouvelle passerelle IP de MU peut comporter jusqu'à 64 caractères. |
Confirm |
Facultatif |
System.Management.Automation.SwitchParameter |
Ce paramètre suspend le traitement par la commande et demande à l'administrateur de confirmer les actions que la commande va effectuer avant de continuer le traitement. La valeur par défaut est $true. |
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. |
TemplateInstance |
Facultatif |
System.Management.Automation.PSObject |
Ce paramètre spécifie que la cmdlet utilise la configuration d'un objet existant, lorsque cet objet est fourni au paramètre, pour créer une copie identique de l'objet sur un serveur local ou cible. |
UMDialPlan |
Facultatif |
Microsoft.Exchange.Configuration.Tasks.UMDialPlanIdParameter |
Ce paramètre spécifie le plan de numérotation de MU à associer à la passerelle IP de MU. |
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, l'administrateur peut afficher les 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
L'exemple du premier code crée une passerelle IP de messagerie unifiée appelée MyUMIPGateway permettant au serveur de messagerie unifiée de commencer à accepter les appels à partir d'une passerelle IP disposant d'une adresse IP 10.10.10.1.
Le deuxième exemple de code crée une passerelle IP de messagerie unifiée appelée MyUMIPGateway qui permet au serveur de messagerie unifiée de commencer à accepter les appels à partir d'une passerelle IP disposant d'un nom de domaine complet MyUMIPGateway.contoso.com.
New-UMIPGateway -Name MyUMIPGateway -Address 10.10.10.1
New-UMIPGateway -Name MyUMIPGateway -Address "MyUMIPGateway.contoso.com"