Share via


Set-UMIPGateway (RTM)

 

S’applique à : Exchange Server 2007

Dernière rubrique modifiée : 2007-07-12

La cmdlet Set-UMIPGateway permet de modifier les paramètres de configuration d'une passerelle IP de messagerie unifiée (MU) unique ou de retourner une liste des paramètres de configuration pouvant être modifiés sur une passerelle IP de MU donnée.

Syntaxe

Set-UMIPGateway -Identity <UMIPGatewayIdParameter> [-Address <UMSmartHost>] [-DomainController <Fqdn>] [-Name <String>] [-OutcallsAllowed <$true | $false>] [-Port <Int32>] [-Simulator <$true | $false>] [-Status <Enabled | Disabled | NoNewCalls>]

Set-UMIPGateway [-Address <UMSmartHost>] [-DomainController <Fqdn>] [-Instance <UMIPGateway>] [-Name <String>] [-OutcallsAllowed <$true | $false>] [-Port <Int32>] [-Simulator <$true | $false>] [-Status <Enabled | Disabled | NoNewCalls>]

Description détaillée

La cmdlet Set-UMIPGateway modifie les paramètres de configuration pour une passerelle IP de MU donnée, par exemple, l'adresse IP de la passerelle IP. Ces modifications incluent l'autorisation d'appels sortants et le contrôle des communications avec une passerelle IP ou IP-PBX compatible SIP.

importantImportant :
Il est possible que des modifications des paramètres de la passerelle IP de MU perturbent la communication entre les serveurs de messagerie unifiée et la passerelle IP IP-PBX ou compatible SIP. Les modifications de l'objet passerelle IP de MU doivent uniquement être effectuées par un administrateur qui comprend parfaitement les implications de l'apport de modifications de configuration à la passerelle IP de MU.

Pour exécuter la cmdlet Set-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

Identity

Obligatoire

Microsoft.Exchange.Configuration.Tasks.UMIPGatewayIdParameter

Ce paramètre spécifie l'identificateur de la passerelle IP de MU en cours de modification. Ce paramètre est l'identificateur d'objet Annuaire pour la passerelle IP de MU.

Adresse

Facultatif

Microsoft.Exchange.Data.UMSmartHost

Ce paramètre spécifie l'adresse IP configurée sur la passerelle IP ou l'IP-PBX (IP/Private Branch eXchange) compatible SIP (Session Initiation Protocol).

DomainController

Facultatif

Microsoft.Exchange.Data.Fqdn

Pour spécifier le nom de domaine complet du contrôleur de domaine qui écrit ce changement de configuration dans le service d'annuaire Active Directory, incluez le paramètre DomainController dans la cmdlet.

Instance

Facultatif

Microsoft.Exchange.Data.Directory.SystemConfiguration.UMIPGateway

Ce paramètre spécifie le paramètre d'entrée qui représente une nouvelle passerelle IP.

Nom

Facultatif

System.String

Ce paramètre spécifie le nom complet utilisé pour la passerelle IP de MU. Le nom complet ne peut pas contenir plus de 64 caractères.

OutcallsAllowed

Facultatif

System.Boolean

Ce paramètre spécifie l'autorisation ou non d'utiliser cet objet passerelle IP pour les appels sortants. Cela ne concerne pas le transfert d'appels.

Port

Facultatif

System.Int32

Ce paramètre spécifie le port IP sur lequel la passerelle IP ou l'IP PBX écoute. Par défaut, il s'agit du port 5060. La plage pour ce paramètre s'étend de 0 à 65535.

Simulator

Facultatif

System.Boolean

Ce paramètre spécifie le simulateur utilisé pour la passerelle IP de MU affichée. Un simulateur permet à un client de se connecter au serveur de messagerie unifiée. Cette connexion est généralement utilisée dans l'application de test de téléphone Exchange.

Status

Facultatif

Microsoft.Exchange.Data.Directory.SystemConfiguration.GatewayStatus

Ce paramètre spécifie d'activer ou de désactiver la passerelle IP de MU.

Types d'entrées

Types de renvois

Erreurs

Erreur Description

 

 

Exceptions

Exceptions Description

 

 

Exemple

Le premier exemple de code modifie l'adresse IP d'une passerelle IP de MU nommée MyUMIPGateway.

Le deuxième exemple de code empêche la passerelle IP de MU d'accepter les appels entrants et empêche les appels sortants.

Le troisième exemple permet à la passerelle IP de MU d'opérer comme un simulateur IP/VoIP.

Set-UMIPGateway -Identity MyUMIPGateway -Address 10.10.10.1

Set-UMIPGateway -Identity MyUMIPGateway -Address 10.10.10.1 -Status 2 -OutcallsAllowed $false

Set-UMIPGateway -Identity MyUMIPGateway -Simulator $true