Partager via


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"